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(54) Video on demand applet method and apparatus for inclusion of motion video in multimedia 
documents 



(57) The present specification describes a computer 
process which requests streams of motion video titles 
and decodes and displays the motion video signals of 
the stream for display in a computer display device is 
constructed in the form of an applet 21 2 of a multimedia 
document viewer 202 such as a World Wide Web brows- 
er. Accordingly, a designer of multimedia documents 
such as HTML pages can easily incorporate motion vid- 
eo titles into such HTML pages by specifying a few pa- 
rameters of a desired title or a desired portion of a title 
to be requested from a video server 250. The applet 21 2 
builds bit stream control signals from the specification 
of the title or the portion of the title. The bit stream control 
signals request transmission of the title or the portion of 
the title from a bit stream server such as a video server 



250 and are in a form appropriate for processing by the 
bit stream server. The applet 212 transmits the bit 
stream control signals to the bit stream server 250 to 
thereby request that the bit stream server 250 initiate 
transmission of a bit stream representing the requested 
title or the requested portion of the title. The applet 212 
also builds decoder control signals from the specifica- 
tion of the title or the portion of the title. The decoder 
control signals direct a bit stream decoder 204 to receive 
the requested bit stream from the bit stream server 250 
and to decode a motion video signal from the bit stream. 
The applet 21 2 transmits the decoder control signals to 
the decoder 204 to cause the decoder 204 to receive 
the bit stream and to decode the motion video signal 
from the bit stream. 



CM 

< 

CO 
CM 
CO 

CO 

o 

00 

o 

LU 



MULTIMEDIA 
DOCUMENT 



APPLET 
212 



MULTIMEDIA 
DOCUMENT 
VIEWER 



OECODER 
204 





COMPUTER 




SYSTEM 




(VIDEO | 




SERVER 




1 250 1 




160 






PROCESSOR 




MAC 


102 




140 


• i 


* 




FIG. I 



Printed by Jouve, 75001 PARIS (FR) 



BNSooao: <£P__pao3eaoA^ju» 



EP 0 803 826 A2 



Description 

A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclo- 
sure, as it appears in the Patent and Trademark Office patent file or records, but otherwise reserves all copyright rights 
whatsoever. 

FIELD OF THE INVENTION 

The present invention relates to computer graphical display of motion video and, in particular, to a method and 
apparatus for facilitating inclusion of motion video in multimedia computer displays. 

BACKGROUND OF THE INVENTION 

Video servers, including networked video servers, transmit M bit streams" to a video client. Such bit streams, which 
are sometimes referred to as "streams, 0 generally represent video and/or audio signals which represent titles in a 
library of multimedia sources. Examples of titles of such a library typically include recordings of motion pictures. In 
general, a video server receives from a video client a request for a particular title and transmits a stream of the particular 
title to the video client. An example of a video client is a set top box which is generally known and which decodes the 
stream received from the video server and transmits the decoded signal to a connected television. The requesting of 
a particular title, receiving the stream of the particular title, and decoding the stream for display on a television are 
collectively and generally referred to as video on demand. 

Examples of such video on demand servers are described in U.S. Patent Application Serial Number 08/572,639, 
filed December 14, 1995 by Kallol Mandal and Steven Kleiman and entitled "Method and Apparatus for Delivering 
Simultaneous Constant Bit Rate Compressed Video Streams at Arbitrary Bit Rates with Constrained Drift and Jitter" 
(hereinafter the '639 Application) and in U.S. Patent Application Serial Number 08/572,648, filed December 14, 1995 
by Kallol Mandal and Steven Kleiman and entitled "Method and Apparatus for Distributing Network Bandwidth on a 
Video Server for Transmission of Bit Streams Across Multiple Network Interfaces Connected to a Single Internet Pro- 
tocol (IP) Network" (hereinafter the '648 Application). Both the '639 Application and the '648 Application are incorporated 
herein in their entirety by reference. 

The popularity of the Internet global network is growing extremely rapidly, and perhaps the most popular protocol 
of the Internet is the Hyper Text Transfer Protocol (HTTP) of the World Wide Web. According to the HTTP protocol of 
the World Wide Web, documents, which are generally referred to as "pages," incorporate text, graphical images, sound, 
and motion video which, when viewed, form a multimedia presentation to user Such pages are typically viewed using 
a World Wide Web browser, which is a computer process capable of retrieving HTTP pages and presenting the contents 
of such pages to a user of a computer system through output devices such as a computer video display device and a 
computer audio circuit coupled to one or more audio speakers. An example of a World Wide Web browser is the 
Netscape browser available from Netscape Communications Corporation of Mountain View, California. 

To display motion video, conventional browsers typically (i) transfer to the computer system in which the browser 
executes an entire data file which includes data representing a title and (ii) subsequently initiate execution of a player 
computer process which displays the title to the user on a computer display device. The player computer process is 
separate from the browser and therefore displays the motion video of the title outside of the page displayed by the 
browser. In addition, transferring the entire data file prior to displaying the motion video of the title delays substantially 
the display of. the motion video since such data files are typically quite large, e.g., typically 1.8 gigabytes of data to 
represent a two-hour, VHS-quality motion picture. 

Currently, no browser is capable of seamlessly integrating motion video streams into a page of the World Wide Web. 

SUMMARY OF THE INVENTION 

In accordance with the present invention, a computer process which requests streams of motion video titles and 
decodes and displays the motion video signals of the stream for display in a computer display device is constructed 
in the form of an applet of a multimedia document viewer such as a World Wide Web browser. Accordingly, a designer 
of multimedia documents such as HTML pages can easily incorporate motion video titles into such HTML pages by 
specifying a few parameters of a desired title or a desired portion of a title to be requested from a video server. The 
specification of the parameters is in the general form of a well-known parameter specification format dictated by the 
particular interface of the computer instruction language in which the applet is written. 

The applet builds bit stream control signals from the specification of the title or the portion of the title. The bit stream 
control signals request transmission of the title or the portion of the title from a bit stream server such as a video server 
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and are in a form appropriate for processing by the bit stream server The applet transmits the bit stream control signals 
to the bit stream server to thereby request that the bit stream server initiate transmission of a bit stream representing 
the requested title or the requested portion of the title. 

The applet also builds decoder control signals from the specification of the title or the portion of the title. The 
decoder control signals direct a bit stream decoder to receive the requested bit stream from the bit stream server and 
to decode a motion video signal from the bit stream. The applet transmits the decoder control signals to the decoder 
to cause the decoder to receive the bit stream and to decode the motion video signal from the bit stream. 

By using an applet of a multimedia document viewer to request and control receipt by a decoder of a motion video 
bit stream and to control decoding of the motion video bit stream by the decoder, a designer of a multimedia document 
can easily and conveniently include motion video images in multimedia documents. In addition, since the applet trans- 
mits bit stream control signals to a video server, the motion video signals which can be incorporated into a multimedia 
document are any such motion video signals stored in such a video server. Such video servers will likely include a 
large number and wide variety of motion video signals, thereby providing a wealth of motion video content for inclusion 
in multimedia documents. 

The present invention will now be further described, by way of example, with reference to the accompanying 
drawings, in which:- 

Figure 1 is a block diagram of a computer system which is connected to a video server through a network and 
which includes a multimedia document viewer which in turn processes an applet to include motion video images in a 
representation of a multimedia document in accordance with the presenting invention. 

Figure 2 is a block diagram showing the multimedia document viewer, applet, and video server of Figure 1 in 
greater detail. 

Figure 3 is a block diagram of an applet tag of Figure 2 in greater detail. 
Figure 4 is a block diagram of the applet of Figure 2 in greater detail. 

DETAILED DESCRIPTION 

In accordance with the present invention, a multimedia document 206 (Figure 2) includes an applet 214 which 
causes a multimedia document viewer 202 to execute an applet 212. Execution of applet 212 requests transmission 
of a bit stream of a particular title from a video server 250 and controls receipt and decoding of the bit stream by a 
decoder 204. Decoder 204, in response to control signals received from applet 212, decodes the received bit stream 
to produce a motion video image and displays the motion video image as an integral part of the representation of 
multimedia document 206. To include a motion video image as an integral part of a multimedia document, a designer 
of the multimedia document simply includes in the multimedia document an applet tag, e.g., applet tag 214, which 
specifies (i) applet 212, (ii) video servoer 250 as the source of a bit stream, and (iii) the particular bit stream to request 
from video server 250. A brief description of the operating environment of multimedia document viewer 202 and applet 
212 facilitates appreciation ofthe present invention. 

Figure 1 is a block diagram of a computer system 100 which is generally of the architecture of most computer 
systems available today. Computer system 100 includes a processor 102 which fetches computer instructions from a 
memory 104 through a bus 106 and executes those computer instructions. In executing computer instructions fetched 
from memory 104, processor 102 can retrieve data from or write data to memory 104, display information on one or 
more computer display devices 1 30, or receive command signals from one or more user-input devices 1 20. Processor 
102 can be, for example, any of the SPARC processors available from Sun Microsystems, Inc. of Mountain view, 
California. Memory 104 can include any type of computer memory including, without limitation, randomly accessible 
memory (RAM), read-only memory (ROM), and storage devices which include magnetic and optical storage media 
such as magnetic or optical disks. Computer 100 can be, for example, any of the SPARCstation workstation computer 
systems available from Sun Microsystems, Inc. of Mountain View, California. 

Sun, Sun Microsystems, the Sun Logo, Java and Hot Java are trademarks or registered trademarks of Sun Mi- 
crosystems, Inc. in the United States and other countries. All SPARC trademarks are used under license and are 
trademarks of SPARC International, Inc. in the United States and other countries. Products bearing SPARC trademarks 
are based upon an architecture developed by Sun Microsystems, Inc. 

Computer display devices 1 30 can include generally any computer display device such as a printer, a cathode ray 
tube (CRT), light-emitting diode (LED) display, or a liquid crystal display (LCD). User input devices 120 can include 
generally any user input device such as a keyboard, a keypad, an electronic mouse, a trackball, a digitizing tablet, 
thumbwheels, a light-sensitive pen, a touch-sensitive pad, or voice-recognition circuitry. 

Computer system 100 also includes network access circuitry 140 which is coupled to processor 102 and memory 
1 04 through bus 1 06 and which is coupled to a network 1 50. In accordance with control signals received from processor 
102 through bus 106, network access circuitry 140 coordinates transfer of data through network 150 between network 
access circuitry 140 and similar network access circuitry (not shown) in computer 100B or other computer systems 
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coupled to computer system 1 00 through network 1 50. The transfer of data through network 1 50 is conventional. Since 
a video stream representing a VHS-quality motion picture encoded in MPEG-1 format has a bit rate of approximately 
1.5 Mbit/second to 2 Mbit/second, a useful minimum threshold is that network access circuitry 140 is capable of re- 
ceiving data at a rate of at least 2 Mbit/second. Higher quality motion video images have bit rates as high as 8 Mbit/ 
5 second or higher. Therefore, in one embodiment, network access circuitry 1 40 is capable of receiving data at a rate of 
at least 8 Mbit/second. Network access circuitry 140 can be generally any circuitry which is used to transfer data 
between a computer system and network such as computer system 100 and network 150 and can be, for example, 
an Ethernet controller chip. 

A number of computer processes execute in processor 102 from memory 104, including a multimedia document 
10 viewer 202 and a decoder 204. Multimedia document viewer 202 is a computer process which reads a multimedia 
document 206 and displays the multimedia information specified in multimedia document 206 in one or more of com- 
puter display devices 1 30. In one embodiment, multimedia document 206 is a document in HTML format and multimedia 
document viewer 202 is an HTML viewer such as the Netscape World Wide Web browser available from Netscape 
Communications Corporation of Mountain View, California. Multimedia document viewer 202 and multimedia document 
15 206 are shown in greater detail in Figure 2. 

Multimedia document viewer 202 retrieves data and tags from a multimedia document such as multimedia docu- 
ment 206. A tag is data which is not itself substantive content of a multimedia document but instead provides format 
information and can include specification of substantive content which is to be included in the multimedia document 
and which is located in memory 104 outside of multimedia document 206. For example, a tag can specify a file stored 
in memory 104 as containing a graphical image which is to be included as substantive content of multimedia document 
206. The data and tags of multimedia document 206 collectively define the composition, including substantive content 
and formatting, of multimedia document 206; and multimedia document viewer 202 displays such substantive content 
in one or more of computer display devices 1 30 (Figure 1 ) in accordance with the data and tags of multimedia document 
206. In one embodiment, multimedia document 206 is an HTML document, and the data and tags of multimedia doc- 
ument 206 comport with the HTML language. Multimedia document 206 includes an applet tag 214 (Figure 2) which 
specifies an applet 21 2 and a number of operational characteristics of applet 212 as described more completely below 
Multimedia document viewer 202 includes an applet interpreter 210 which retrieves from applet 212 computer 
instructions and translates such computer instructions into computer instructions of a form appropriate for execution 
by processor 102 (Figure 1) and submits the translated computer instructions to processor 102 for execution. In one 
embodiment, applet interpreter 210 (Figure 2) translates and submits for execution a single computer instruction of 
applet 212 prior to translation and submission for execution of a subsequent computer instruction of applet 212. Applet 
interpreter 210 can be, for example, the Java applet interpreter or the Hot Java World Wide Web browser available 
from Sun Microsystems, Inc. and, in such an embodiment, applet 212 comports with the Java computer instruction 
language interpreted by the Java applet interpreter. As described more completely below, applet 212 is a novel applet 
which, when executed by processor 102 (Figure 1) through applet interpreter 210 (Figure 2), requests a title from a 
video server 250 and causes the received bit stream representing the requested title to be decoded in a decoder 204 
and displayed in a computer display device as an integral part of a multimedia display of multimedia document 206. 

In executing the computer instructions of applet 212, applet interpreter 210 transmits, through network 1 50 (Figure 
1 ), control signals to an applications programming interface (API) 252 (Figure 2) of a video server 250 which executes 
within a computer system 160 (Figure 1). Illustrative examples of video server 250 of computer system 160 are de- 
scribed in the '639 and '648 Applications. API 252 (Figure 2) of video server 250 implements a remote procedure calling 
(RPC) protocol in which API 252 controls video server 250 in response to control signals received by API 252. For 
example, in response to control signals which request a title and which are transmitted to API 252 by applet interpreter 
210, API 252 causes a bit pump 254 of video server 250 to initiate transmission through network 150 (Figure 1) to 
decoder 204 (Figure 2) of a bit stream representing the requested title. In addition, API 252 can transmit to applet 
interpreter 210 status information regarding a title stored within video server 250 or regarding a bit stream transmitted 
by bit pump 254 in response to control signals requesting such status information. 

Decoder 204 is a computer process executing within processor 102 (Figure 1) from memory 104. Decoder 204 
receives data representing a motion video display encoded in a particular format. In one embodiment, decoder 204 is 
the MPEG Expert (MPX) decoder available from Applied vision and decodes motion video signals according to the 
MPEG-1 encoding format. Applet interpreter 210 transmits to decoder 204 control signals which control the decoding 
by decoder 204 of the bit stream received from bit pump 254 of video server 250. Specifically, applet interpreter 210 
transmits to decoder 204 control signals directing decoder 204 to start or stop decoding the bit stream received from 
bit pump 254 or specifying characteristics of the bit stream received from bit pump 254 such as the bit rate, encoding 
format, and the coordinates of a particular location within one or more of computer display devices 130 (Figure 1) in 
which to display the decoded motion video images. In addition, applet 212 determines which communications port 
through network access circuitry 140 (Figure 1) the bit stream is to be received and transmits to decoder 204 (Figure 
2) control signals identifying the selected communications port. Applet 212 can therefore determine which communi- 
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cations ports are used by other applications and can avoid conflicts resulting from access of decoder 204 of a com- 
munications port by selecting a communications port which is not used by another computer process of computer 
system 100 (Figure 1). 

Applet tag 21 4 is shown in greater detail in Figure 3. Applet tag 214 includes a number of fields which collectively 
s define a bit stream to be received and decoded for display by decoder 204 (Figure 2). A field is a collection of data' 
which collectively define a item of information. Applet tag 21 4 includes (i) an applet identifier field 302, (ii) a width field 
304, (iii) a height field 306, (iv) a server identifier field 308, and (v) an encoding format field 310. Applet tag 214 can 
also include any of the following optional fields: (vi) a title field 312, (vii) an image field 314, (viii) a play/pause field 
316, (ix) a start field 318, and (x) a duration field 320. 

10 Applet identifier field 302 specifies applet 212 as the applet to be retrieved and executed by applet interpreter 210. 

Width field 304 and height field 306 specify the width and height, respectively, in display coordinate space of a computer 
display device, i.e., specify the size of the viewport in which the decoded motion video image is displayed. Server 
identifier field 308 specifies video server 250 (Figure 2) as the source of the desired bit stream. Encoding format field 
310 (Figure 3) specifies the particular encoding format, e.g., MPEG 1 SYS encoding format, ofthe bit stream received 

is by decoder 204 (Figure 2). Title field 312 (Figure 3) specifies the particular title to be retrieved from server 250 (Figure 
2). Alternatively, title field 312 can specify the address of a multicast bit stream. 

Image field 314 (Figure 3), if included, specifies a still video image to be displayed in the space specified by width 
field 304 and height field 306 if the title specified by title field 312 is unavailable. Play/pause field 316, if included, 
specifies whether the motion video image received from video server 250 (Figure 2) is initially in a play state or in a 

20 paused state. Start field 318 (Figure 3), if included, specifies an offset into the title of a portion of the title, i.e., the point 
within the title at which the bit stream should begin. For example, start field 318 can specify that the requested bit 
stream begin at 3 minutes and 1 0 seconds into the title. Duration field 320, if included specifies the duration of a desired 
portion of the title. For example, duration field 320 can specify that a 30-minute portion of the title is requested. In one 
embodiment, start field 318 and duration field 320 are specified in terms of an integer number of nanoseconds.^ 

25 Thus, by specifying the few fields described above and shown in Figure 3, a designer of multimedia document 206 

can include as an integral part of multimedia document 206 a motion video image retrieved from video server 250. The 
following is an illustrative example of applet tag 214 in HTML format. 

<applet code="SunMediaCenterPlayer.class" width=704 height=520> 
30 <param name=port value="1 973"> 

<param name=format value="MPEG1SYS"> 
<param name=host value="sqas-6"> 
<param name=img value=7images/bkgx.gif"> 
</applet> 

35 

Applet 212 (Figure 2) includes computer instructions which, when executed, request a title from video server 250 
and control decoding and display of the decoded motion video signals by decoder 204 and is shown in greater detail 
in Figure 4. The computer instructions of applet 21 2 are organized into various levels, each of which defines a respective 
component of the behavior of applet 212. Applet 212 includes a player level 402, an API level 404, a decoder level 
40 406, and a detailed decoder level 408. 

Player level 402 includes computer instructions which, when executed, implement a graphical user interface in 
which a user can control the bit stream received by video server 250 (Figure 2) and the display of the decoded motion 
video signals of the bit stream by physical manipulation of one or more of user input devices 120 (Figure 1). In one 
embodiment, the computer instructions of player level 402 (Figure 4), when executed, cause graphical and/or textual 
^5 representation of control mechanisms to be displayed in one or more of computer display devices 1 30 (Figure 1 ). Such 
control mechanisms are known and conventional and include, without limitation, virtual buttons, pull-down menus, 
virtual radio buttons, virtual check boxes, and sliding scroll bars. In a conventional manner, a user activates one or 
more of such control mechanisms by physical manipulation of one or more of user input devices 120 (Figure 1) and 
such physical manipulation results in receipt by player level 402 (Figure 4) of applet 212 of signals and/or data repre- 
ss senting such activation. 

API level 404 includes computer instructions which, when executed, implement the RPC protocol of API 252 (Figure 
2) of video server 250 and invoke RPC calls to API 252 to control the bit stream transmitted by bit pump 254 in ac- 
cordance with interaction of a user with the graphical user interface implemented by player level 402 (Figure 4). 

Decoder level 406 and detailed decoder level 408 collectively control operation of decoder 204 (Figure 2), generally 
55 controlling the decoding of the bit stream received from video server 250 by decoder 204 and the display in a computer 
display device of the decoded motion video image. Decoder level 406 includes computer instructions and data struc- 
tures which are not specific to any particular decoder, while detailed decoder level 408 includes computer instructions 
and data structures which are specific to decoder 204. It is generally preferred that detailed decoder level 408 is as 
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small and simple as possible such that the majority of computer instructions of decoder levels 406 and 408 are included 
in decoder level 406. Accordingly, adapting applet 212 (Figure 2) to operate in conjunction with a decoder other than 
decoder 204 requires modification of only detailed decoder level 408 and, therefore, as little modification as possible. 

Appendix A is a computer source code listing of a preferred embodiment of applet 21 2. The modules of Appendix 
A are written in the Java applet computer instruction language developed by Sun Microsystems, Inc. of Mountain View; 
California. The computer instructions of the Java applet computer instruction language are object-oriented, and each 
of the modules of Appendix A represents a respective class of objects. Player level 402 (Figure 4), in this embodiment, 
includes classes SunMediaCenterPlayer, Player, and PositionSlider as defined in the computer source code listing of 
Appendix A. API level 404, in this embodiment, includes classes MsmPlayer, MsmSession, MsmAccessRight, Msm- 
Persistence, MsmPlaylist, MsmToString, Msmltem, MsmTitleltem, MsmDeadAirltem, MsmException, XdrBlock, and 
PortMapper as defined in the computer source code listing of Appendix A. Decoder level 406, in this embodiment, 
includes classes Decoder and Decoderlmpl as defined in the computer source code listing of Appendix A. Detailed 
decoder level 408, in this embodiment, includes class MpxDecoderlmpI as defined in the computer source code listing 
of Appendix A. 

In the preferred embodiment of the present invention defined by Appendix A, a module "loop" includes computer 
instructions of the C computer instruction language and defines a loop computer process which executes independently 
of multimedia document viewer 202 (Figure 2). The loop computer process cooperates with multimedia document 
viewer 202 and decoder 204 to request and receive from video server 250 bit streams representing multicast motion 
video signals. 

The above description is illustrative only and is not limiting. The present invention is therefore defined solely and 
completely by the appended claims together with their full scope of equivalents. 
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SunMediaCenterPlayer 

/* 

w * @ (#) SunMediaCenterPlayer . java 

* 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 
+ 

* version 1 . 0 

* author Christopher Lindblad 

it 

*/ 

import j ava . applet . * ; 
import j ava . awt . * ; 
import j ava .net . * ; 
import java.io.*; 
import COM. Sun. isg . smcj c. * ; 

public class SunMediaCenterPlayer extends Applet { 
private Player player; 
private TextArea reporter; 
private Thread thread; 

public SunMediaCenterPlayer ( ) { 
setLayout (new BorderLayout ( ) ) ; 
player = new Player (); 
add ("Center", player); 
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public synchronized void initO ( 
if (reporter != null && reporter . getParent ( ) == this) 
remove (reporter ) ; 
reporter . setText ( " " ) ; 
validate ( ) ; 

} 

try { 

int port=getParameterInt ("port", -1) ; 
int vc=get Parameter Int ( "vc" , - 1 ) ; 
if (vc!=-l) { 
player . ini t ( 

getParameterRequired ("host" ) , 
getParameterRequired ("title") , 
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getParameterLong ("start", OL) , 
getParameterLong { "duration" , OL) , 
get Parameter String ("loop", 
s "false" ) . equal slgnoreCase ( "true" ) , 

getParameterString ("and", "play") , 
getParameterlmage ( "img" , null ) , 
vc, "", 

getParameterURL ( "CC" ) , 
10 getParameterRequired("interface") ) ; 

}else{ 

if (port==-l) { 
player . init ( 
15 getParameterRequired ("host" ) , 

getParameterRequired ( "title" ) , 
getParameterLong ( "start "/ OL) , 
getParameterLong ( "duration" , OL) , 
getParameterString ( " loop" , 
20 "false") . equalsIgnoreCase ( " true" ) , 

getParameterString ("cmd", "play") , 
getParameterlmage ( " img" , null ) / 
port," ", 

getParameterURL ("CC") , null) / 
25 }else{ 

player. init ( 

getParameterRequired ( "host " ) , 
"none", OL, OL, false, "play", 
3Q getParameterlmage (" img" , null) , 

port, 

getParameterRequired ( " format" ) , 

getParameterURL ("CC") ,null) ; 

} 

35 } 

} catch (IOException e) { 

report (e, "parsing Sun MediaCenter player parameters"); 

} 

} 

40 

public synchronized void start () { 
try player . start () ; catch (IOException e) 

report (e, "starting a Sun MediaCenter player") ; 



public synchronized void stop() { 
try player . stop () ; catch (IOException e) 

report (e, "stopping a Sun MediaCenter player"); 

so } 
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private String getParameterRequired (String key) throws 
IOException { 

String val = getParameter (key) ; 
s if (val != null) return val; 

throw new IOException ( "missing required parameter " + key); 

} 



private int getParameterlntRequired (String key) throws 
10 IOException { 

String val = getParameter ( key) ; 
if (val != null) 

try return Integer . parselnt ( val ) ; catch 
1S (NumberFormatException e) 

throw new IOException ( 

.. "parameter " + key + " is not a valid int: " + 

val ) ; 

20 throw new IOException ( "missing required parameter " + key); 

} 

private URL getParameterURL (String key) { 
URL res=null; 
25 String val = getParameter ( key ) ; 

if (val ~ null) return null; 
try res=new URL(val); 

catch (Malf ormedURLExcept ion e) try res=new 
3Q URL (getDocumentBase ( ) , val) ; 

catch (Malf ormedURLException f) 
System. out .println ( "Malf ormedURLException" ) ; 
return res; 

} 

35 

private String getParameterString (String key, String dflt) { 
String val = getParameter ( key ) ; 
if (val == null) return dflt; 
return val; 



45 



private int getParameter Int ( String key, int dflt) throws 
IOException { 

String val = getParameter ( key ) ; 
if (val == null) return dflt; 
try return Integer . parselnt (val ) ; catch 
(NumberFormatException e) 

throw new IOException ( 
50 "parameter " + key + " is not a valid int: " + val); 

} 
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private long getParameterLong (String key, long dflt) throws 
IOException { 

String val = getParameter ( key) ; 
if (val == null) return dflt; 

try return Long. parseLong (val) ; catch (NumberFormatException 

e) 

throw new IOException ( 
"parameter + key + " is not a valid long: " + val); 



private Image getParameterlmage (String key, Image dflt) { 
String val = getParameter ( key) ; 
if (val == null) return dflt; 
return get Image (getDocumentBase ( ) , val); 



private synchronized void report (Except ion e, String doing) { 
ByteArrayOutputStream os = new ByteArrayOutputS tream ( ) ; 
PrintStream ps = new Prints tream (os ) ; 
ps .print ( "An error occurred while " ) ; 
ps .print (doing) ; 
ps .println (":"); 
e , prints tackTrace (ps) ; 
if (reporter == null) { 

reporter = new TextArea ( " " ) ; 

reporter .setEditable (false) ; 

} 

reporter . appendText (os . toS tring ( ) ) ; 
if (reporter. getParent ( ) != this) { 

add ("North", reporter); 

validate ( ) ; 

} 

} 
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Player 

/* 

* @ (#) Player. java 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 
* 

* version l.lsc 

* author Christopher Lindblad ( Msm API & Mpx API ) 

* author Stephane CACHAT (Closed Caption & Multicasting) 

*/ 

package COM. Sun. isg . smcjc; 



Import java . applet . * ; 
import java.awt.*; 
20 import java.io.*; 
import java.net.*; 

public class Player extends Panel implements Runnable { 
private long playDuration; 
25 private long startOffset; 

private long seekPosition; 
private long tellPosition; 
private double tellPositiond; 
private MsmPlayer player; 
private String host; 
private String titleName; 
private String msg; 
private String formats- 
private Image img; 
private Thread thread; 
private Panel controlLine; 
private Panel controlButtons ; 
private TextArea reporters- 
private Decoder decoder; 
private PositionSlider posi tionSlider ; 
private Button [] buttons; 
private int cmd = 999; 
private int initialCmd; 
45 private int port; 

private boolean loop; 
private boolean Msm; 
private URL CC; 
private List CCt; 

so 
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private int CCz=0; 

private String [] CCb=new String [1024] 
private Doublet] CCi=new Double [1024] 
private int CC1=0, 
private int CCo=0, 
private int CCm=0, 
private boolean playing = false; 
private TextField CCs; 
private String ATM; 



public Player () { 
setLayout (new BorderLayout ( ) ) ; 
decoder = new Decoder (); 
15 add ("Center", decoder) ; 

} ' * 

public synchronized void init ( 
String host, String titleName, 

long startOffset, long playDura tion, boolean loop, 
String cmd, Image img, int port, String format, URL CC, String 



20 



ATM) 



25 



throws IOException { 

URLConnection uc; 
Double d; 
String str; 
int i=0; 
int j=0; 



30 



this .port=port ; 

if ( (port !=-l) && (ATM==null) ) { 

Msm=false; 
}else{ 

35 Msm=true; 

this . initialCmd = parseCmd (cmd) ; 

} 

this.CC=CC; 
this. ATM= ATM ; 
40 this, host = host; 

this . titleName = titleName; 
this . startOffset = startOffset; 
this .playDuration = playDuration; 
this. loop = loop; 
this . img = img; 
this. format = format; 
if (CC!=null) { 
CCt= new List () ; 
CCt .minimumSize (6) ; 
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CCt .pref erredSize (6) ; 
uc= CC . openConnection ( ) ; 
DatalnputStream in=new 
5 DatalnputStream (uc . get InputStream ( ) ) ; 

str= M -"; 
CCb[i]=new String ("* " ) ; 

CCi(i]=new Double(O.O); 
i + +; 

io while ( in . available () >0) ( 

str=in ♦ readLine ( ) ; 
while 

( (str. trim( ) . length () ==0) && ( in . available ( ) >0) ) strain . readLine () 
if (str !=null) { 
15 j=str . trim ( ) . indexOf ( 1 f ); 

if (j>0) { 

CCb[i]=new String (str . substring (j+1) ) . trim() ; 
CCt . addl tern (CCb [ i ] ) ; 
if (CCb[i]==null) CCb [ i ] =" * " ; 
CCi [ i] =new Double {str . substring (0, j ) . trim ( ) ) ; 
i++; 

} 



20 



25 



30 



} 

CCm=i-l ; 
in .close ( ) 



} 



> 



public synchronized void start () throws IOException { 
if (reporter != null && reporter . getParent ( ) this; 
remove (reporter) ; 
reporter . setText ( " " ) ; 
35 validate ( ) ; 

} 

if (thread null) { 
cmd = initialCmd; 
thread = new Thread ( this) ; 
40 thread, start ( ) ; 

} 

} 

public synchronized void stop() throws IOException { 
45 if (thread != null) { 

thread = null; 
notify ( ) ; 
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public synchronized boolean action (Event evt, Object arg) { 
if (buttons != null && evt. target instanceof Button) { 
Button b = (Button) evt . target ; 
for (int i = 0; i < buttons . length; i++) { 
if (b == buttons [i]) cmd - i; 

} 

notify ( ) ; 

}; 

if (CC != null && evt. target ==CCt) { 
seekPosition = (long) (new 
Double (CCi [CCt . getSelectedlndex ( ) ] . doubleValue ( ) +10) . intValue ( ) ) * 
100000000; 

cmd = SEEK; 
notify () ; 

>; 

if (CC != null && evt . target-=CCs) { 
if (CCKCCm) { 

CCz=CCl+l; 
} else { 
CCz=0; 

}; 

2S while { (CCz!=CCl) && (CCbfCCz] . indexOf (CCs . getText ( ) )<0) ) { 

CCz++; 

if (CCz>CCm) CCz=0; 

} 

if (CCb [CCz] . indexOf (CCs. get Text ( ) ) >=0) { 
30 CCt .select (CCz) ; 

CCt . make Visible (CCz+1) ; 
seekPosition = (long) (new 
Double (CCi [CCt. getSelectedlndex ( ) ] .doubleValue () *10) . intValue () )* 
100000000; 
35 cmd - SEEK; 

notify ( ) ; 
} 

} 

return true; 

40 ) 

private void setConnect (MsmConnect connect ) throws 
IOException { 
try { 

player . setConnect (connect) ; 
} catch (MsmException e) { 

/* Try it with destTiAddr in beta 0.5 syntax. */ 
System. out . println ( "DesTiAddr= n +connect . destTiAddr) ; 
50 InputStream is = new 
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StringBuf f erlnputStream (connect . destTiAddr ) ; 

StreamTokenizer st = new StreamTokeni zer ( is ) ; 
String host; 
s int udpport; 

if (ATM==nuli) { 
if (st .nextToken ( ) == StreamTokenizer . TT_W0RD 
st . sval .equals ( "host" ) 
st . nextToken ( ) == ■ = ' && 
io st . nextToken ( ) — StreamTokenizer . TT__WORD && 

(host = st. sval) != null && 
st .nextToken ( ) == 

st .nextToken ( ) == StreamTokenizer . TT_W0RD && 
st. sval. equals ("udpport") && 
st .nextToken ( ) == * = ' 

st . nextTaken ( ) == StreamTokenizer . TT_MUMBER 
(udpport = { int ) st . nval ) != 0) { 
connect .destTiAddr = "beO, "+host+ " , "+udpport ; 
player. setConnect (connect) ; 

} else { 
throw e; 
} 

}else{ 
throw e; 
} 

} 

} 
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public synchronized void run { ) ( 
Thread currentThread = Thread. currentThread {) ; 
MsmSession session = null; 
MsmTitle title = null; 

MsmltemU items = null; 
35 int speed=0; 



if (Msm) ( 

controlButtons = new Panel (); 
controlButtons . setLayout (new FlowLayout ( ) ) ; 
controlButtons . add (cmds [PAUSE] , new 
Button (labels [PAUSE] ) ) ; 

controlLine = new Panel () ; 

controlLine . setLayout (new BorderLayout (') ) ; 
controlLine. add ("East", controlButtons) ; 
positionSlider = new PositionSlider ( this ) ; 
controlLine. add ("Center", positionSlider) ; 
add ("South", controlLine); 
if (CC!=null) { 
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Panel CCp=new Panel (); 
CCp . setLayout (new BorderLayout ( ) ) 
Panel CCq=new Panel (); 
5 CCq. setLayout (new BorderLayout () ) 

CCs= new TextField ( 15) ; 
CCs. isEditable () ; 
CCq. add ("South", CCs) ; 
10 Label l=new Label ( "Search" ) ; 

CCq.add("Center", 1) ; 
CCp. add ("East", CCq) ; 
CCp.add("Center",CCt) ; 
controlLine . add ( "North" , CCp) ; 
} 

> - * 

try { 

if (Msm) { 



75 
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items = new MsmI tern [ 1 ] ; 
session = new MsmSession (host ) ; 
title = session. cetTitleStatus ( ti tleName) ; 
if (playDuration == 0L) playDuration = 
title . tot a 1 PlayDuration ; 
2$ forma t=ti tie . format ; 

} 

' decoder . init (format, img, host, port , ATM) ; 
if (Msm) { 

titlelnit (title) ; 
30 player = new MsmPlayer (session, info(), 

MsmPlayer . TIME_MAXTIME) ; 

player . setPersistence (new MsmPersis tence ( 
MsmPersistence . TYPE_N0NE, 
MsmPlayer . TIME_MAXTIME) ) ; 
35 items {0] = new MsmTi tlel tern ( 

ti tleName, playDuration, startOf fset, playDuration, 
playDuration, false, true, title .maxBitRate) ; 
player. setPlaylist (new MsmPlaylist ( 
MsmPlayer. TIME CURRENT, loop, 0, 
40 MsmPlayer . TIME_MAXTIME, 

items, 0,0)); 
setConnect (new MsmConnect ( 
decoder .destTiAddr () , decoder . encap () , 
title .maxBitRate) ) ; 
45 playing = false; 

speed = MsmPlayer . SPEED FORWARD; 
}else{ 

invalidate ( ) ; 
so validate (); 
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} 

while (currentThread " thread) { 
switch (cmd) { 
5 case NOP: { 

if (Msm) { 

MsmPlayStatus status = 

player . getPlayStatus ( ) ; 

if ( tellPosit ion != status . currentPosit ion) { 
10 tellPosition = s tatus . currentPosit ion; 

positionSlider . repaint ( ) ; 

} 

tellPositiond= (tellPosition/ 100 0000000) + 3.0; 
^ if (CC!=null) { 

. * CCo=CCl; 

while 

( (CCi [CC1+1] .doubleValue ( ) <tellPositiond) && (CCl + KCCm) ) CC1++; 

while 

( (CCi [CCI] . doubleValue ( ) >tellPosi tiond) && (CC1>0) ) CCI — ; 

if (CCo!=CCl) ( 

CCt. select (CC1-1) ; 
CCt .makeVisible (CCI) ; 

} 

) 

player . set Persistence (new MsmPersistence ( 
MsmPersistence . TYPE_NONE, 
status. currentDate+60*1000000000L) ) ; 

} 

break; 
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case PAUSE: { 

decoder . pause ( ) ; 

35 if (Msm) player .pause (MsmPlayer . TIME_CURRENT) ; 

decoder . flush ( ) ; 
playing = false; 
decoder .play ( ) ; 
break; 

40 } 

case GOTO_START: { 

tellPosition = 0L; 

if (Msm) positionSlider . repaint ( ) ; 
decoder. stop ( ) ; 

if (Msm) player . play (MsmPlayer . SPEED_FORWARD / 
0L, 
0L, 

MsmPlayer . TIME_CURRENT) ; 
so decoder . flush ( ) ; 
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break; 

} 

case GOTO_END: { 

tellPosition = playDuration; 

if (Msm) positionSlider . repaint ( ) ; 

decoder . stop ( ) / 

if (Msm) player .play (MsmPlayer . SPEED_REVERSE, 
playDuration, 
0L, 

MsmPlayer .TIME_CURRENT) ; 
decoder . f lush ( ) ; 
break; 

} 

case SEEK: { 

tellEpsition = seekPosition; 
if (Msm) positionSlider . repaint () ; 
if (playing) { 
decoder . flush ( ) ; 
if (Msm) player .play (speed, 
seekPosition, 
MsmPlayer . TIME_MAXTIME, 
MsmPlayer . TIME J3URRENT) ; 

} else { 
long duration = S EEKDURAT I ON ; 
long position = seekPosition-duration; 
if (position < OL) { 

duration += positions- 
position -= position; 

} 

decoder . play ( ) ; 
decoder . flush ( ) ; 

if (Msm) player . play (MsmPlayer . SPEED_F0RWARD, 
position, 
duration, 

MsmPlayer. TIME CURRENT); 

} 

break; 

} 

default: { 

decoder .play ( ) ; 
decoder . flush ( ) ; 
if (Msm) { 

speed = cmd; 
player .play (speed, 

MsmPlayer . TIME_CURRENT, 
MsmPlayer . TIME_MAXTIME, 
MsmPlayer .TIME CURRENT); 
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playing = true; 

if (CC!=null) 

if (CCo!=CCl) { 
5 CCt .select (CC1-1) ; 

CCt .makeVisible (CCD ; 

} 

} 

) 

10 } 

cmd = NOP; 

try wait(lOO); catch ( InterruptedExcept ion e) ; 

} 

} catch (Exception e) { 

report (e, "communicating with a Sun MediaCenter 
server") ; & 
} finally { 
try { 

try decoder . stop () ; catch (Exception e) 

report (e, "stopping a video decoder") ; 

if (Msm) { 
if (player != null) { 

try player .delete {) ; catch (Exception e) 
25 report (e, "deleting a Sun MediaCenter 

player" ) ; 

player - null; 
} 

} 

30 ) finally { 

if (Msm) { 
if (session != null) { 

try session . close () ; catch (Exception e) 
report (e, "closing a Sun MediaCenter 

35 connection" ) ; 

} 

} 

} 

} 

} 
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/* 

* Callback from the Position's! ider . 

* Unsynchronized to avoid deadlock. 

* Sreturn value between 0 and 1 indicating where in the file 
we are. 

V 

public double tellO { 
if (playDuration == OL) return 0.0D; 
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return (double) tellPosition / (double ) playDuration; 

} 

s /* 

* Callback from the PositionSlider . 

* Seek to a relative position in a file. 

* @param position Value between 0 and 1 

* indicating where in the file to go. 
w * / 

public synchronized void seek (double position) { 
if (playDuration == 0) return; 

seekPosition = (long) (posi tion*playDuration) ; 
cmd = SEEK; 
notify () ; 
} - * 
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private String infoO throws UnknownHostException { 
String hostName = 
InetAddress . getLocalHost ( ) . getHostName ( ) ; 

String javaVersion = System . get Proper ty ( " j ava . version" ) 
String javaVendor = System . getProperty ( " j ava . vendor ") ; 
String osArch = System. getProperty ( "os . arch" ) ; 
25 String osMame = System. getProperty ( "os . name" ) ; 

String osVersion = System. getProperty ( "os . version" ) ; 
return hostName 

+ M Java " + javaVersion + " ( " + javaVendor + ")" 
+ " (" + osArch + " " + osName + " " + osVersion + 



30 " ) " ; 
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} 

private void addButton ( int i) { 
buttons [i] = new Button ( labels [ i ]) ; 
controlButtons . add (cmds [i] , buttons [i] ) 

} 
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* Initialize for a title. 

* @param title The title to play. 
*/ 

private void titlelni t (MsmTitle title) throws IOException { 
controlButtons . removeAll ( ) ; 
45 buttons = new Button [ labels . length] ; 

for (int i = MsmPlayer . SPEED_SLOWEST_FORWARD; 
i <= MsmPlayer . S?EED_SCENE_FORWARD; 
i + +) { 

if (title . speedScale [ i ] != 0) { 
50 addButton (GOTO START); 
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break; 

) 

} 

5 for (int i = MsmPlayer . S?EED_SCENE_REVERSE; 

i <= MsmPlayer . SPEED_SLOWEST_REVERSE ; 
i + +) { 

if (title . speedScale [ i ] != 0) addButton ( i ) ; 

} 

10 addButton (PAUSE) ; 

for (int i - MsmPlayer . SPEED_SLOWEST_FORWARD; 
i <= MsmPlayer. SPEED_SCENE_FORWARD; 
i + +) ( 

if (title. speedScale [i] != 0) addButton ( i ) ; 

15 } 

for (int i = HsmPlayer . SPEED_SCENE_REVERSE ; 
i <= MsmPlayer .SPEED_SLOWEST_REVERSE; 
i + +) ( 

if (title. speedScale[i] != 0) ( 
addButton (GOTO_END) ; 
break; 

} 

} 

2 5 /* recompute layout */ 

controlLine . invalidate ( ) ; 
invalidate ( ) ; 
validate ( ) ; 

/* resize if we need to */ 
30 Component c = getParent{); 

while (c ! = null ) { 

if (c instanceof Applet) { 

Dimension ps = c .pref erredSize ( ) ; 
• Rectangle b = c. bounds (); 
if (ps.width != b. width || ps. height != b. height) 
// This wedges Netscape Navigator 2.0 
// c. resize (ps .width, ps. height); 

} 

break; 

} 

} 
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} 

private void report (Exception e, String doing) { 
ByteArrayOutputStream os = new By teArrayOutputS tream ( ) ; 
PrintStream ps = new Pr intStream (os ) ; 
ps. print ("An error occurred while " ) ; 
ps .print (doing) ; 
so ps . pr intln ( " : " ) ; 
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e.printStackTrace (ps) ; 
if (reporter == null) { 

reporter = new TextArea ( " " ) ; 

reporter . setEditable ( false) ; 

} 

reporter . appendText (os . toString ( ) ) ; 
if (reporter . getParent ( ) != this) { 

add ("North", reporter) ; 

validate ( ) ; 

} 

} 

private int parseCmd (String cmd) throws IOException { 
for (int i = 0; i < cmds. length; i++) { 

if (cmd.equalsIgnoreCase (cmds [i] ) ) return i; 

} 

throw new IOException ( "Not a valid Player command: "+cmd) 

} 

private static final long S E EKDURAT I ON = 4 000000000L; 

private static final int PAUSE = 16; 
private static final int GOTO_START = 17; 
private static final int GOTO_END = 18; 
private static final int SEEK = 19; 
private static final int NOP = 20; 

private static final String [] labels = { 



"|««", // MsmPlayer . SPEED_SCENE_REVERSE 

"««", // MsmPlayer . SPEED_FASTEST_RE VERSE 

"<«" , // MsmPlayer . SPEED_FASTER_REVERSE 

"«", // MsmPlayer . S PEE D_FAST__RE VERSE 

"<"/ // MsmPlayer . SPEED_REVERSE 

" l<", // MsmPlayer . SPEED_SLOW_REVERSE 

"I I < " / // MsmPlayer . SPEED_SLOWER_REVERSE 

"II l<"/ // MsmPlayer . SPEED_SLOWEST__REVERSE 

">l II"/ // MsmPlayer . SPEED_SLOWEST_FORWARD 

">M"/ // MsmPlayer . SPEED_SLOWER__FORWARD 

">!"/ // MsmPlayer . SPEED_SLOW_FORWARD 

">", // MsmPlayer .SPEED_FORWARD 

">>", // MsmPlayer . SPEED_FAST_FORWARD 

">>>", // MsmPlayer . SPEED_FASTER_FORWARD 

"»»"/ // MsmPlayer . SPEED_FASTEST_FORWARD 

// MsmPlayer . SPEED_SCENE_FORWARD 

"II"/ // PAUSE 

"||««", // GOTO_START 

I " / // GOTO END 
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// SEEK 
// NOP 



}; 



private static final String [] cmds' = 



"scene_reverse' , 
" fast est_re verse" 
"faster_reverse" , 
" f ast_reverse" , 
"reverse", 
"slow_reverse" , 
"slower_reverse" , 
M slowest_re verse" 
11 slowest_f orward" 
" slower_f orwai^d" , 
" slow_f orward" , 
"play", 

" fas t_f orward", 
"f as ter_f orward" , 
" f astest__f orward" , 
" scene^f orward" , 
"pause", // 
"goto_start" / 

"goto^end", 

"seek", 

"noo", 



// MsmPlayer . SPEED_SCENE_REVERSE 
// MsmPlayer . SPEED_FASTEST_REVERSE 
// MsmPlayer . SPEED_FASTER_RE VERSE 

// MsmPlayer . SPEED_FAST_REVERSE 
// MsmPlayer . SPEED__ REVERSE 

// MsmPlayer .S PEE D_SLOW_RE VERSE 
// MsmPlayer . SPEED_SLOWER_REVERSE 
// MsmPlayer . SPEED_SLOWEST_REVERSE 
// MsmPlayer . SPEED_SLOWEST_FORWARD 
// MsmPlayer . SPEED_SLOWER_FORWARD 

// MsmPlayer . SPEED_SLOW_FORWARD 
// MsmPlayer . SPEED_FORWARD 

7/ MsmPlayer ,SPEED_FAST_FORWARD 
// MsmPlayer . SPEED_FASTER_FORWARD 

// MsmPlayer . SPEED_FASTEST_FORWARD 
// MsmPlayer. SPEED_SCENE_FORWARD 
PAUSE 

// GOTO_START 
// GOTO_END 

// SEEK 
// NOP 



}; 
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PositionSlider 

/* 

s * @ (#) PositionSlider . java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

w * author Christopher Lindblad 

*/ 

package COM.Sun.isg.smcjc; 

15 

import java.awt.*; * 
import java.io.*; 

class PositionSlider extends Canvas { 
private Player player; 
private int hgap; 
private int vgap; 
private int wid; 



public PositionSlider (Player player) { 
this (player, 5, 5, 6) ; 

} 

public PositionSlider (Player player, int hgap, int vgap, int 
wid) { 

this .player = player; 
this. hgap = hgap; 
this. vgap = vgap; 
this . wid = wid; 



public void update (Graphics g) { 
paint (g) ; 



public synchronized void paint (Graphics g) { 
Rectangle r = bounds (); 

int position = ( int) ( (r . width-hgap*2) *player . tell ()) +hgap; 

g . setColor ( getBackground ( ) ) ; 

g. f illRect (0, 0, r. width, vgap*2) ; 

g. f illRect (0, r . height-vgap*2, r. width, vgap + 2); 

g. f illRect (0, vgap*2, r . width-hgap*2, r . height-vgap*2) ; 
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g. fillRect (r . width-hgap, vgap* 2, r .width, r . height -vgap* 2 ) 
g. fill3DRect (hgap, vgap* 2, r . width-hgap* 2 , r . height- vgap* 4 
false) ; 

g . f ill3DRect (position-2, vgap, wid, r . height-vgap*2 , true) 

} 

private synchronized void seek(int x) { 
Rectangle r = bounds () ; 
double position = ( (double) (x-hgap) ) / 
( (double) (r . width-hgap*2 ) ) ; 

if (position < 0.0D) position = 0.0D; 
if (position > 1.0D) position = 1.0D; 
player . seek (position) ; 



public boolean mouseDown (Event e, int x, int y) { 
seek (x) ; 
return true; 



public boolean mouseDrag (Event e, int x, int y) { 
seek (x ) ; 
return true; 



} 

30 
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MsmPlaver 

/* 

* @ (#) MsmPlayer . java 



* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 



* version 1.0 

* author Christopher Lindblad 



* 

*/ 



package COM . Sun . isg . smc j c ; 
import java.io.*; * 



/** 

* Media Stream Manager Client API 
* 

* MSM allows for the creation of "players". A player is a 
persistent entity 

* that provides for the scheduled delivery of isochronous data 
lo a 

25 * particular destination. To accomplish this task, a player 

maintains a H yer 

this layliSt ° f titleS/ the state of a "Playhead" which traverses 

playlist, and an access list controlling who can perform 
30 various functions 

* on the player . 

* MSM, when supplied with titles that have been prepared for 
presentation at ^ 

35 * multiple presentation rates, manages the position index 

lookups and stream 

* switching necessary for "trick play". 

* Associated with a player is a "playhead" that maintains a 
40 destination for 

♦the isochronous data (possibly different than the controlling 

client) and a ^ 

* "playPosition" which travels along the playlist at the 
selected 

to P£! sentation rate and Olivers isochronous data as scheduled 

* destination. The position, presentation rate, and 
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presentation direction 

* of the playhead can be controlled via playO, pause (), and 
resume ( ) . The 

* initiation of play can be synchronized with "wail clock time' 1 
via play ( ) ; 

* presentation will then stay synchronized with wall-clock time 
as long as 

* presentation rate and direction are Normal-Rate, 
Forward-Direction . 

* Latency from invocation of the playO request until actual 
start of stream 

* may be reduced by M pre-roll ing" with a playO request that has 
zero 

* duration. This jmay also be used to set a current playlist 
position without 

* actually starting play. 

* MSM manages concurrent updates to a playlist by returning a 
modi f ication 

* timestamp with playlist status. The modification timestamp 
indicates the 

* time of the last modification of the playlist. When a client 
wishes to 

* update a playlist, the client will first obtain status 
containing a 

* modification timestamp to understand the current state of the 
playlist. 

* Based on this status, the client then determines the 
appropriate updates 

* and passes those updates along with the modification timestamp 
of the 

* status on which the updates were based to msm. If msm finds 
that the 

* modification timestamp has not changed, implying that the 
clients updates 

* are based on currently valid playlist state, the playlist 
update will 

* succeed. If the modification timestamp indicates that the 
playlist has 

* been modified since this client obtained status, the update 
will be 

* rejected. In this case, the client should reobtain status, 
reaccess the 

* update, and then if appropriate resubmit the update with the 
modification 

* timestamp of the new status. There is a designated timestamp 
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that forces 

* playlist modifications, this may be used if some external 
method of 

s * concurrency control is preferred. 

* MsmPlaylist may be edit while play is in progress. Normally, 
changes to the 

* playlist will not take effect until the current item in play 
w completes . A 

* playlist modification can be forced to take effect immediately 
by calling 

* resume (). resume () should be called with the speed argument 
being the 

is * current (or desired new speed) and the s tartPosi tion argument 

being A 

* TIME_CURRENT. If the contents of the playlist at the current: 
position of . 

* the playhead have not been modified, this call will not 
20 disrurb the 

* outgoing data stream. 
* 

* MSM optionally maintains players persistently across server 
outages. When 

* this option is selected, a successful return from a player 
request 

* indicates that the player modifications have been made 
persistently. 

* Persistent players may optionally restart play on state 
recovery, play may 

* be restarted at the last played position or at the position 
that the 

* position that play would be add had no outage occurred. 
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* Access to read and modify players is controlled by access 
control lists 

* associated with the players. These may be modified by 

* msmPlayerSetAccess ( ) . 
* 

* Access rights are "Read", "Control", and "Admin". Read rights 
all state to 



* be seen. Control rights allow "trick-play" ooerations to be 
controlled. 

45 * Admin rights allow creation of players, and connection, 

access, and 

* persistence attributes of players to be set. Access rights 
are associated 



with "agents" (eg users) appropriate for the authorizati 
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mechanism 

* selected. The reserved agent name "*" represents ALL agents, 
those 

s * granting a right to , grants the right to all agents . 

V 

public class MsmPlayer { 

private MsmSession session; 
w private byte ( ] handle; 

/** 

* Creates a player. The player is initialized 
non-persistent. 

15 * @param session A server session. 

* @param inf o ^Saved, but uninterpreted by server. May be 

null. 

* Used to describe the player for administrative purposes. 

* @param terminateDate Date at which player should be 
20 auto-deleted. 

* If TIME_MAXTIME, the player will never be auto-deleted, 
it must 

* be deleted via delete. 

* @exception IOException If an error has occurred. 

public MsmPlayer (MsmSession session, String info, long 
terminateDate) 

throws IOException { 

this. session = session; 

XdrBlock call = session . newCall ( PLAYER_CREATE) ; 
call . xdroutString (info) ; 
call . xdroutMsmTime (terminateDate) ; 
XdrBlock reply = session . rpc (call ) ; 
handle = reply . xdrinBytes (HANDLELEN) ; 
reply .done ( ) ; 

} 
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MsmPlayer (MsmSession session, XdrBlock xdr) ( 
this. session = session; 
handle = xdr . xdrinBytes (HANDLELEN) ; 



void xdrout (XdrBlock xdr) { 
45 xdr . xdroutBytes ( handle, HANDLELEN) ; 

} 

public MsmSession getSession() { 
return session; 

so 
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) 

public byte [J getfiandle ( ) { 
return handle; 

} 

* Opens an existing player. 

* @param session A server session. 

*^@param handle An opaque handle to the player. 

public MsmPlayer (MsmSession session, byte[] handle) { 
this. session = session; 
15 this, handle = handle; 

/ * * 

stopped 06161 " 65 ^ Piayer - In P ro <^ess play of the player is 
'^exception IOException If an error has occurred. 

public void delete () throws IOException { 
XdrBlock call = session. newCall (PLAYER DELETE) • 
this . xdrout (call ) ; ~~ 
^ session. rpc (call) .done() ; 
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/** 

* Modifies access control list for player 

* @param rights The access modifications 

* ^exception IOException If an error has occurred. 
/ 

Tor™i iC V ? ld setAccess ( M smAccessRight[] rights) throws 
j-vjii.xcep tion { 

XdrBlock call = session . newCall (PLAYER SETACCESS) ; 
this .xdrout (call) ; 

call .xdroutlnt (rights . length) ; 
for (int i = 0; i < rights . length; i++) 
rights [i] .xdrout (call) ; 

session. rpc (call) .done () ; 

} 

/** 

* Get access control list for player 

* @return The access modifications. 

* ^exception IOException If an error has occurred 



50 



55 



BNsooctD: <£p_peoaaaaAaJU> 



30 



EP 0 803 826 A2 



public MsmAccessRight [ ] getAccessO throws IOException { 
XdrBlock call = session . newCall ( PLAYER_GETACCESS ) ; 
this . xdrout (call ) ; 
5 XdrBlock reply = session . rpc (call ) ; 

MsmAccessRight [] result = new 
MsmAccessRight [reply. xdrinlnt ( ) ] ; 

for (int i = 0; i < result . length; i++) { 
result [i] = new MsmAccessRight (reply) ; 

10 } 

reply, done ( ) ; 
return result; 

> 

75 /** 

* Sets persistence for player. 

* @param prstp A MsmPersis tence containing the persistence 
to be set . 

* @exception IOException If an error has occurred. 

20 */ 

public void setPersistence (MsmPersistence prst) throws 
IOException { 

XdrBlock call = session .newCall (PLAYER_SETPERSISTENCE) ; 
this .xdrout (call) ; 
prst . xdrout (call ) ; 
session . rpc (call ) ,done(); 

} 

/ ★ ★ 

* Get persistence information for player. 

* @exception IOExceotion If an error has occurred. 
V 

public MsmPersistence getPersistence ( ) throws IOException { 
XdrBlock call = session .newCall (PLAYER_GETPERSISTENCE) ; 
this . xdrout (call ) ; 

XdrBlock reply = session . rpc (call ) ; 

MsmPersistence result = new MsmPersistence ( reply) ; 
reply . done ( ) ; 
return result; 

} 

/** 

* Replaces a portion of the playlist for this player. The 
portion to be 

* replaced and the new titles to inserted are indicated via 
MsmPlaylist 

* struct pointed to by playlistp. 
' * @param playlist A MsmPlaylist that indicates the period on 
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50 



the playlist 

* to be (re) scheduled and the new titles to place within 
that period . 

5 ^exception lOException If an error has occurred. 

public void setPlaylist (MsmPlaylist playlist) throws 
lOException { 

XdrBlock call = session .newCall (PLAYER SETPLAYLIST) ; 
w this .xdrout (call) ; ~~ 

playlist .xdrout (call) ; 
session. rpc (call) .done () ; 

} 

15 /** 

* Obtains a ..pcyrtion of the playlist for this player. 

* @param startPosition The position within the playlist at 
which to start 

* returning status . 

* Gparam playlis tDurat ion The number of miliiseseconds of 
the playlist for 

* which to return status. 

^exception lOException If an error has occurred. 

public MsmPlaylist getPlaylist (long startPosition, lona 
playlis tDurat ion) y 
throws lOException { 

XdrBlock call = session . newCall (PLAYER GETPLAYLIST); 
this. xdrout (call) ; ~~ 
call .xdroutMsmTime (startPosition) ; 
call .xdroutMsmTime (playlistDuration) ; 
XdrBlock reply = session . rpc (call ) ; 
MsmPlaylist result = new MsmPlaylist (reply ) ; 
reply.done{) ; 
return result; 

} 

/** 

* Obtains the playlist for this player. 

* ^exception lOException If an error has occurred. 

* / 

public MsmPlaylist getPlaylist ( ) throws lOException { 
^return getPlaylist (TIME_ZER0, TIME_MAXTIME) ; 

/ * * 

* MsmConnects a player to the specified destination address 
An error is return if play is in progress at the time of a 
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setConnect ( ) . 

* @param connect A MsmConnect instance containing a 
transport- independent 

5 * address string for the destination of Media Server data 

controlled 

* by this player. A connectp of NULL disconnects the 
player from the 

* current destination. 

10 * @exception IOException If an error has occurred. 

V 

public void setConnect (MsmConnect connect) throws IOException 

{ 

XdrBlock call = session . newCall ( PLAYER_SETCONNECT ) ; 
is this .xdrout (call) ; 

connect ♦ xdrout^cali ) ; 
session. rpc (call) .done ( ) ; 

} 

20 / + * 

* Get current connection for player. 

* @exception IOException If an error has occurred. 
*/ 

public MsmConnect getConnect { ) throws IOException { 
25 XdrBlock call = session .newCall ( PLAYER_GETCONNECT ) ; 

this. xdrout (call) ; 

XdrBlock reply = session . rpc ( call ) ; 
MsmConnect result = new MsmConnect ( reply) ; 
reply .done ( ) ; 
return result; 

} 
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* Schedules play to commence at startDate. Play 

* will begin at playlist startPosit ion and continue for 
playDuration NPT 

* seconds or until paused. An error is returned if the 
player is not 

* connected. 

* Only one play() command can be pending, a second playO 
overrides any 

* pending play ( ) . 

* @param speed The speed at which to play. 

4S * @param startPosit ion The position within the playlist at 

which to begin 

+ play. TIME_CURRENT means the current play position. 

* Gparam playDuration The duration of play. 

* TIME_MAXTIME indicates "forever". 

so 
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10 



* @param startDate The wall-clock time of day at which to 
begin play. 

A value of T IME_CURRENT means start play immediately. 

* ^exception IOException If an error has occurred. 
V 

public void play( 
int speed, long startPosi tion, long playDuration, long 
startDate ) 

throws IOException { 

XdrBlock call = session . newCall ( PLAYER_PLAY) ; 
this .xdrout (call) ; 
call -xdroutlnt (speed) ; 
call . xdroutMsmTime ( startPosi tion) ; 
?5 call. xdroutMsmTime (playDurat ion) ; 

call. xdroutMsmTime (startDate) ; 
session. rpc (call) ,done() ; 

) 

20 /* * 

*■ Pauses play on the player. 

* Only one paused command can be pending, a second pause () 

* overrides any pending pause (). 

* @param pausePosi t ion The position within the Dlaylist at 
which to pause 

V playing. If current play position is later than 
pausePosition 

* (taking into account the direction of play), play pauses 
immediately. 

* A value of TIME_CURRENT means stop immediately. 

* @return The time at which play actually paused. 

* ^exception IOException If an error has occurred. 
*/ 

public long pause (long pausePosition) throws Exception { 
XdrBlock call = session . newCall (PLAYER_PAUSE) ; 
this . xdrout (call) ; 

call .xdroutMsmTime (pausePosition) ; 
XdrBlock reply = session . rpc (call ) ; 
long result = reply . xdrinMsmTime () ; 
reply . done ( ) ; 
return result; 

} 
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/** 

* Resumes playing. Play will continue until paused 

* or the end of the playlist (looped playlists play 
forever) . 

* Sparam speed The speed at which to resume play. 
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* @param startPosi tion The position within the playlist at 
which to 

* resume play. TIME_CURRENT means the current play 
s position. 

* @exception IOException If an error has occurred. 
V 

public void resume (int speed, long startPosi tion) throws 
IOException { 

10 XdrBlock call = session . newCall ( PLAYER_RESUME ) ; 

this . xdrout (call ) ; 
call . xdroutlnt (speed) ; 
call . xdroutMsmTime ( star tPosi tion) ; 
session. rpc (call) .done ( ) ; 

15 } 

/** 

* Get play state for a player. 

* @return A MsmPlayStatus instance. 

* ^exception IOException If an error has occurred. 
*/ 

public MsmPlayStatus getPlayStatus ( ) throws IOException { 
XdrBlock call = session . newCall (PLAYER_GETPLAYSTATUS ) ; 
this .xdrout (call) ; 

XdrBlock reply = session . rpc ( cal 1 ) ; 
MsmPlayStatus result = new MsmPlayStatus ( reply) ; 
reply . done ( ) ; 
return result; 

} 

30 

public String toStringO { 
return MsmToString . playerToS tring (this) ; 

} 

private static final int HANDLELEN = 12; 

public static final long TIME_SADTIME = -1L 
public static final long TIME_CURRENT = -2L 
public static final long TIME_2ER0 = 0L 
public static final long T I ME_MAX T I ME = 2147483 64 7 999999999L 
public static final long TIME_MINTIME = 1L 

public static final int SPEED_SCENE_RE VERSE = 0; 

45 public static final int SPEED_FASTEST_REVERSE = 1; 

public static final int SPEED_FASTER_RE VERSE = 2; 

public static final int SPEED_FAST_RE VERSE = 3; 

public static final int S PEE D_REVERS E = 4; 

public static final int SPEED_SLOW_RE VERSE = 5; 

50 
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public static final int SPEED_SLOWER_REVERSE = 6; 

public static final int SPEED_SLOWEST_REVERSE = 7; 

public static final int SPEED_SLOWEST_FORWARD = 8; 

public static final int SPEED_SL0WER_F0RWARD = 9; 

public static final int SPEED_SL0W_F0RWARD = 10; 

public static final int SPEED_FORWARD = 11; 

public static final int SPEED_FAST_FORWARD = 12; 

public static final int SPEED_FASTER_FORWARD = 13; 

public static final int SPEED_FASTEST_FORWARD = 14; 

public static final int SPEED_SCENE_FORWARD = 15; 
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final 
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PROG = 
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MsmSession 

5 / + 

* @ (#) MsmSession . j ava 

* Copyright .1995 Sun Microsystems, Inc. All Rights Reserved. 

10 * version 1.0 

* author Christopher Lindblad 

V 

15 package COM, Sun . isg. smcjc; 

import java.io.*; * 
import java.net.*; 
20 import java . util . * ; 

/ * * 

* Media Stream Manager Client API 

25 * The Media Stream Manager (msm) API provides an RPC interface 
for managing 

* the scheduling and play of isochronous media streams. 
V 

public class MsmSession { 
^0 private String serverHostName; 

private Socket socket; 

private Inputs tream is; 

private OutputStream os; 

private int prog; 
35 private int vers; 

f ★ * 

* Create a RPC session for the named server. 

4Q * @param serverHostName The host name of a MSM server. 

* @exception IOException If an error has occurred. 
*/ 

public MsmSession (String serverHostName) throws IOException { 
this . serverHostName = serverHostName; 
45 socket = new Socket ( serverHostName, pmapGet Port ( ) ) ; 

is = new Buff eredlnputS tream ( socket . get Inputs tream ()) ; 
os = new Buf feredOutputStream (socket . getOutputS tream ( )) ; 

} 

50 private int pmapGetPort ( ) throws IOException { 
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PortMapper pmap = null; 
try { 

5 pmap = new PortMapper ( serverHostName ) ; 

int port; 
prog = 100236; 
vers = 1 ; 

port = pmap. getPort (prog, vers, PortMapper . I PPR0T0_TC?) 
w if (port != 0) return port; 

prog = 0x206d736d; 
vers = 1; 

port = pmap . getPort (prog, vers, PortMapper . I PPROTO_TCP) 
if (port != 0) return port; 
is } finally { 

if (pmap != null) pmap . close () ; 
> - * 

throw new MsmExcept ion ( "no msm server on "+serverHos tName ) ; 
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/** 

* Closes a session with an MSM server. 

* @exception MsmException If an error has occurred. 
V 

public void closed throws IOException { 
socket .close ( ) ; 



/** 

* All players on this server. 

* @return an array of all players. 

* ^exception IOException If an error has occurred. 
*/ 

35 public MsmPlayer [ ] players () throws. IOException { 

XdrBlock reply = rpc (newCall (PLAYER_LIST) ) ; 
MsmPlayer[] result = new MsmPlayer [ reply . xdrinlnt ()] ; 
for (int i = 0; i < result . length; i++) { 
result[i] = new MsmPlayer (this, reply); 

40 } 

reply . done ( ) ; 
return result; 

} 



50 



* Obtains status about titles. 

* @param titleName The name of the title on which to obtain 
status . 

* @return the status of the title. 

* @exception IOException If an error has occurred. 
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*/ 

public MsmTitle getTitleStatus (String titleName) throws 
IOException { 

XdrBlock call = newCall ( TITLE__GET STATUS ) ; 
call .xdroutString (titleName) ; 
XdrBlock reply = rpc(call); 

MsmTitle result = new MsmTitle ( reply ) ; 
reply . done ( ) ; 
return result; 

} 



XdrBlock newCall(int proc) { 
return new XdrBlock (prog, vers, proc) ; 

} 

synchronized XdrBlock rpc (XdrBlock call) throws IOException 
call . send (os) ; 

XdrBlock reply = new XdrBlock ( is) ; 
try { 

reply • xdrinReplyHeader (call . callXid ( ) ) ; 
} catch (IOException e) { 

throw new MsiuException (call . callProc ( ) , e . ge tMessage ( ) ) 



int err = reply . xdrinlnt <) ; 

if (err != 0) throw new MsmException (call . callProc () , err); 
return reply; 



15 



/ -k * 

* Returns the server host name. 
*/ 

public String getServerHostName ( ) { 
return serverHostName; 
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public String toStringO { 
return MsmToString . sessionToString (this) ; 
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private 
private 
private 
private 



static final int SERVER_AUTHTYPE 
static final int PLAYER_CREATE 
static final int PLAYER_DELETE 
static final int PLAYER_LIST 
static final int PLAYER_SETACCESS 
static final int PLAYER_GETACCESS 
Static final int PLAYER_SETPERSISTENCE 
static final int PLAYER GET PERSISTENCE 
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private static final int 
private static final int 
private static final int 
private static final int 
private static final int 
private static final int 
private static final int 
private static final int 
private static final int 



PLAYER_SETPLAYLIST = 9 

PLAYER_GET PLAYL 1ST =10 

PLAYER_SETC0NNEC7 =11 

PLAYER_GETCONNECT = 12 

PLAYER_PLAY =13 

PLAYER__PAUSE =14 

P LAY E R__R£ S UME =15 

PLAYER_GET PLAYS TATUS =16 

TITLE_GETSTATUS =17 
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MsmAccessRight 

/ + 

. * @ (#) MsmAccessRight . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
★ 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM. Sun . isg . smc j c; 
/ * ★ .. * 



* Access types, operations on access lists, and rights and 

* lists of access rights. 

* Access types (read, admin, control) are the access catagories 

* defined by the MSM server (see MSM doc for each request to 

* determine the access catagory of that request). Access op's 

* are the operations that can be made to alter access rights of 

* a particular user. An access right is the pairing of access 

* catagories with a particular user. An access list is a 
collection 

* of access rights for multiple users. 
*/ 

public class MsmAccessRight { 
30 public String name; 

public int access; 
public int op; 

public MsmAccessRight (String name, int access, int op) { 
35 this, name = name; 

this. access - access; 
this. op = op; 

} 

40 MsmAccessRight (XdrBlock xdr) { 

name = xdr . xdrinString ( ) ; 
access = xdr . xdrinlnt ( ) ; 
op = xdr . xdrinlnt () ; 

} 



void xdrout (XdrBlock xdr) 
xdr .xdroutString (name) ; 
xdr .xdroutlnt (access) ; 
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xdr.xdroutlnt (op) ; 
public String toStringf) { 

^ return MsmToString . accessRightToString (this) ; 

public static final int ACCESS NONE = 0- 
public static final int ACCESS ADMIN - i- 
public static final int ACCESS~READ =2*' 
public static final int ACCESS CONTROL = 4; 
public static final int ACCESS~ALL = 7; 

public static final int 0P_ADD = 0; 
public static 4inal int OP_REMOVE = l; 
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MsmPersistence 



* @ (#)MsmPersistence . java 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 
* 



is package COM. Sun . isg . srucjc; 
■ /** 

* MsmPersistence information 
V 

20 . public class MsmPersistence { 
/** 

* Indicates the date at which the player should be 

* automatically deleted. - On termina teDate, play if in 
25 progress, will 

* be stopped and the player deleted. A terminateDate of 
MSMT IME__MAX T IME 

* indicates the player should never be automatically 
deleted. 

30 */ 

public long terminateDate; 

public int type; 

35 public MsmPersistence (int type, long terminateDate) { 

this. type = type; 

this . terminateDate = terminateDate; 

} 

w MsmPersistence (XdrBlock xdr) { 

type = xdr .xdrinlnt ( ) ; 
terminateDate = xdr . xdr inMsmTime ( ) ; 

} 

is 

void xdrout (XdrBlock xdr) { 
xdr .xdrou tint (type) ; 
xdr .xdroutMsmTime (terminateDate) ; 

} 



55 



BNSDOCtO: <£P_06O3B2aA2JL> 



43 



15 



20 



25 



EP 0 803 826 A2 

public String toString ( ) ( 

^return MsmToS tring . persis tenceToString ( this) ; 
/** 

*^No persistence across server outage. 

public static final int TYPE NONE = 0; 
/** 

restarted!* StatiC State iS P res "ved, P^V not is not 

*/ 

public static final int T YPE_PLAYL 1ST = 1; 

^Play is restarted after outage at last known playPosi tion , 
public static final int TYPE_PLAYPOSITION = 2; 



* Play is restarted after outage as appropriate for current 
*/" 

public static final int TYPE__PLAYCURDATE = 3; 



date. 

*/ 
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MsmPlavlist 

/* 

* @ (#)MsmPlaylist . java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
+ 

* version 1 . 0 

10 * author Christopher Lindblad 
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package COM. Sun . isg. smcjc; 
/** 

* MsmPlaylist positions are measured in seconds and nanoseconds, 
titles on a 

* playlist may be scheduled to start at any non-negative 
position. (In some 

* cases it may be convenient to base playlists positions at 0; 
in other 

* cases it may be better to base them with the OS representation 
of 

* time-of-day. ) The playlist maintains a contiguous sequence of 
titles and 

* "dead air". A schedule may be edited by replacing any 
contiguous 

* sub-sequence of the schedule with another sequence. It is 
also possible 

* to change the starting position of the scheduled list of 
titles. Because 

* of mfs "admission delays", title start times may slip; msm 
35 optionally 

* allows a title to be padded with dead air that can absorb the 
slip, or on 

+ a slip the same title or a later title can be marked to be 
truncated or a 

40 * later title may be " joined-in-progress" to absorb the slip and 
maintain 

* schedule correspondence with clock time. 
V 

public class MsmPlaylist { 
45 / + + 

* On Get, the current modification status stamp. On Put, 
modstamp on 



which mods are based, if modification status has changed. 
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Mods are 

uh . * aborte ^ unless modstamp == MsmPlayer . TIME CURRENT, in 
wnicn case mods — 

* are always done. 
V 

public long modstamp; 
/** 

playlL? n i?em; ^ Starting P 1 *^^ position for the returned 

replaced? ^ ^ playlist position whe " items are to be 
V 

public long editStartPosi tion; 
/** 

the d^iof' ^ t0tal dU " tion of the ^ems returned. On Put, 
items! ° f ^ exi3ting P^Vlist that is to be replaced with new 

for lengS^ ^ PUt ' edit " nge s P ecifi ^ by editStartPosition 

* editDuration must lie entirely within existing playlist. 

listDuratSn^r-^^ 1 ^ 113 ' 0 t0 * et ""St.rtPo.ition -d 

* determine playlist bounds 
*/ 



public long editDuration; 
/** 

Put, the^f' ^ StartPosition the entire playlist. On 

* startPosition for the playlist after edits. 
40 public long listStartPosition; 

/** 

^On Get, the duration of the entire list. On Put, ignored 
4s public long listDuration; 

public Msmltemf] items; 
/* + 

* On Get, the current loop state of the playlist. On Put, 
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if TRUE, the 

* playlist wraps from end->start, start-end. 
*/ 

public boolean isLoop; 

public MsmPlaylist (long rnodstamp, boolean isLoop, long 
edits tart Posit ion, 

long editDuration, Msmltemf] items, 
w long listStartPosi tion, long listDuration) { 

this . rnodstamp = rnodstamp; 
this. isLoop = isLoop; 

this .editStartPosition = edits tartPosi tion; 
this . editDuration = editDuration; 
is this, items = items; 

this . listStartJPosition = listStartPosi tion; 
this . listDuration = listDuration; 

} 

20 MsmPlaylist (XdrBlock xdr) { 

rnodstamp = xdr . xdrinMsmTime ( ) ; 
isLoop = xdr . xdrinBoolean ( ) ; 
editStartPosition = xdr . xdrinMsmTime () ; 
editDuration = xdr . xdrinMsmTime () ; 
25 items = new MsmI tern [xdr . xdrinlnt ()] ; 

for (int i - 0; i < items . length; i++) ( 
■ int itemType = xdr . xdrinlnt () ; 
switch (itemType) { 
30 case TITLE: 

items[i] = new MsmTi tleltem (xdr ) ; 
break; 
case DEADAIR: 
items [i] = new MsmDeadAirl tern (xdr) ; 
35 break; 

} 

> 

listStartPosition = xdr . xdrinMsmTime {) ; 
listDuration = xdr . xdr inMsmTime ( } ; 

40 } 



void xdrout (XdrBlock xdr) { 
xdr . xdroutMsmTime (rnodstamp) ; 
xdr . xdroutBoolean (isLoop) ; 
xdr .xdroutMsmTime (editStartPosition) ; 
xdr .xdroutMsmTime (editDuration) ; 
xdr .xdrout Int (items . length) ; 
for (int i = 0; i < items . length; i + +) { 

if (items [i] instanceof MsmTit lei tern) ( 
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xdr. xdroutlnt (TITLE) ; 

( (MsmTitleltem) items [i] ) .xdrout (xdr) ; 
J else { 

xdr .xdroutlnt (DEADAIR) ; 

( (MsmDeadAirltem) items {i]) .xdrout (xdr) ; 

) 

xdr.xdroutMsmTime distStartPosition) • 
^xdr.xdroutMsraTime(listDuration) ; 

public String toStringO { 
return MsmToString.playlistToString (this) ; 

private static final int TITLE = o- 
private static final int DEADAIR = l; 
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MsmConncct 

* @ (#) MsmConnect . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
+ 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM . Sun . isg . smc jc; 

/* * - 

* Connection paramaters . 

* These parameters are passed directly to mfs str open ( ) . 
*/ 

public class MsmConnect { 
/** 

* The transport independent address. 
**/ 

public String destTiAddr; 
f * ★ 

* The packet encapsulation specifier (eg. MPEG Transport, * 
DSS, etc) . 

*/ 

public String encap; 
/** 

35 * The bits/second network bandwidth to request. 

V 

public int rate; 
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public MsmConnect (String destTiAddr, String encap, int rate) 

this .destTiAddr = destTiAddr; 
this. encap = encap; 
this. rate = rate; 

} 

MsmConnect (XdrBlock xdr) { 
destTiAddr = xdr . xdrinString () ; 
encap = xdr . xdrinString () ; 



so 



55 



BNSDOCtD: <£P_pe038»A«JL> 



49 




EP 0 803 826 A2 



rate = xdr .xdrinlnt ( ) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr . xdroutString (destTiAddr) ; 
xdr . xdroutString (encap) ; 
xdr . xdrout I nt (rate) ; 

} 

public String toStringO { 
return MsmToString. connectToStr ing (this) ; 

} 
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MsmPlayStatus 



/* 

* @ {#) MsmPlayStatus .java 
* 

* 

* version 1.0 

* author Christopher Lindblad 



Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 



*/ 

1S package COM. Sun. isg. smcjc; 
/** 

* MsmPlayStatus indicates the current state of the player. 

* STATE_WAIT indicates that a play command has been given, but 
20 * that startDate has not arrived. 

V 

public class MsmPlayStatus { 
public long pausePosition; 
public long currentDate; 
public long currentPosit ion; 
public String info; 
public int currentState; 
public int currentSpeed; 
30 public boolean pausePending; 

MsmPlayStatus (XdrBlock xdr) { 
info = xdr .xdrinString ( ) ; 
pausePending = xdr . xdrinBoolean ( ) ; 
35 pausePosition = xdr . xdrinMsmTime ( ) ; 

currentState = xdr . xdrinlnt ( ) ; 
currentSpeed = xdr . xdrinlnt () ; 
currentDate = xdr . xdrinMsmTime () ; 
currentPosition = xdr . xdrinMsmTime () ; 

. ) 



public String toStringO {• 
return MsmToString . playStatusToString ( this ) ; 



public static final int. STATE_STOP = 0 

public static final int STATE"WAIT = l 

public static final int STATE_PLAY = 2 

} 
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MsmToString 

/* 

• * @ (#) MsmToString. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM. Sun. isg. smcjc; 

import java . util . * 

class MsmToString { 

static String sessionToString (MsmSession se) { 
return "MsmSession" 

+ " [serverHostName=" + se . getServerHostName ( ) 



static String playerToString (MsmPlayer pi) { 
byte[] h = pi . getHandle ( ) ; 

StringBuffer sb = new StringBuf f er (h . length*2 ) ; 
for (int i = 0; i < h. length; { 
byte b = h [i] ; 
sb. append (Character . forDigit ( (b » 4) & Oxf, 16)); 
^ sb.append (Character . forDigit ( b & Oxf, 16)); 

35 return "MsmPlayer" 

+ " [serverHostName= M + 
pi . getSession (). getServerHostName ( ) 

+ " handle=" + sb . toSt ring ( ) 
+ " ] " ; 

- } 



50 



private static final String [] rights = 
("admin", "read", "control"}; 

private static final String [] ops = { "add" , "remove" } ; 

static String accessRightToString (MsmAccessRight ar) ( 
StringBuffer sb = new StringBuf fer () ; 
for (int i = 0; i < rights . length; i++) { 
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if ((ar.access & (1 « i) ) != 0) { 
if (sb. length () > 0) sb , append ("I") ; 
sb. append (rights [i] ) ; 

} 

} 

if (sb.lengthO == 0) sb . append ( fl none" ) ; 
String op; 

if (ar.op >= 0 && ar.op < ops. length) op = ops [ar.op] 
else op = String . valueOf (ar . op) ; 
return "MsmAccessRight " 
+ " [name=" + ar.name 

+ " access=" + sb . toString ( ) 
+ " op=" + op 
+ "]"; 
} * 

static String connectToString (MsmConnect co) { 
return "MsmConnect" 

+ " [destTiAddr=\" " + co . destTiAddr +»\»» 
encap=\" " + co.encap +"\»" 
+ " rate=" + co.rate 
+ "]"; 



static String deadAirltemToString (MsmDeadAirl tern dai) 
return "MsmDeadAirl tern" 

+ " [itemDuration=" + dai . itemDuration 

+ " joinInDuration=" + dai . joinlnDuration 
+ "]"; 

} 

private static final String [] types = { 
"none", "playlist", "playposi t ion" , "playcurdate" } ; 

static String persis tenceToS tring (MsmPersistence pe) { 
String type; 

if (pe.type >= 0 && pe.type < types . length) type = 
types [pe. type] ; 

else type = S tring . yalueOf (pe . type) ; 
return "MsmPersistence" 
+ " [type=" + type 
+ " 

terminateDate=\" "+dateToS tring (pe . terminateDate) +"\" " 

+ «]«; 

} 

static String da teToString ( long date) { 
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if (date == MsmPlayer . TIME_MAXTIME) return "never"; 
else return new Date (date/ 1 000000L) . toString () ; 

} 

private static final String [] states = 
{ "stop", "wait", "play" } ; 

private static final String [] speeds = ( 
"scenejeverse", " f astest__reverse" , "f aster_reverse", "fast^rev 
erse", 

"reverse", "slow^reverse", ,f slower_reverse" , "slowestjeverse", 
"slowest_forward", "slower__f orward" , "slow_f orward" , "forward", 
" f as t_f orward", " faster_f orward" , " fastest_f orward" , "scene for 
ward"}; ~ 

static String playStatusToString (MsmPlayS tatus ps) { 
String state; 

if (ps . currentState >= 0 && ps . currents tate < s tates . length) 



state = states [ps . currentState] ; 
} else state = String. valueOf (ps .currentState) ; 
String speed; 

25 if (ps .currentSpeed >= 0 && ps . currentSpeed < speeds . length) 

{ 

speed = speeds [ps . currentSpeed] ; 
} else speed « String. valueOf (ps . currentSpeed) ; 
return "MsmPlayS tatus" 
30 + " [info=\"" + ps.info + »\»» 

+ " pausePending=" + ps .pausePending 
+ " pause?osition=" + ps .pausePosition 
+ " currentState=" + state 
+ " currentSpeed=" + speed 

+ " currentDate=\" " + dateToString (ps . currentDate) + 



+ " currentPosition=" + ps . current Position 



} 



50 



static String playlistToString (MsmPlaylist pi) { 
StringBuffer sb = new S tringBuf f er ( ) ; 
if (pi. items != null) { 

for (int i = 0; i < pi . items . length; i++) { 
if (i != 0) sb. append (","); . 
sb. append (pi . items [i] . toString ( ) ) ; 

> 

} 

. re turn "MsmP 1 a y 1 i s t " 
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+ " [modstamp=\" " + dateToString (pi .modstamp) + 
+ " isLoop= ,f + pl..isLoop 

+ " editStartPosition=" + pi . edits tartPosit ion 

+ " editDuration=" + pi . editDuration 

+ " items=[" + sb.toStringO + " ] " 

+ " listStartPosi tion=" + pi . lists tartPosition 

+ " listDuration=" + pi . listDurat ion 

+ "]"; 



10 



static String ti tleToString (MsmTi tie ti) { 
StringBuf f er sb = new StringBuf fer () ; 
if ( ti • speedScale != null) ( 
15 for (int i = 0; i < ti . speedScale . length; i++) { 

if (i !=JD) sb.append(", " ) ; 
sb . append ( ti . speedScale [ i] ) ; 

} 

} 

20 return "MsmTitle" 

+ " [name-V" + ti.name + "X"" 
+ " speedScale^ [ " + sb.toStringO + "J" 
+ " maxBitRate=" + ti .maxBi tRate 
+ " totalPlayDuration= M + ti . totalPlayDurat ion 
+ " format^X" " + ti. format + "\"" 
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static String titlel temToString (MsmTitlel tern ti) 
return "MsmTitlel tern" 

+ " [ titleName=\" M + ti . ti tleName + "X" " 
'+ " itemDuration= n + ti . itemDuration 
+ " startOf fset«" + t i . startOf f set 
+ " playDuration=" + ti .piayDuration 
+ " joinInDuration=" + ti . joinlnDurat ion 

+ " isTimeLocked=" + t i . isTimeLocked 

+ " playClosestSpeed=" + ti . playClosestSpeed 
+ " maxBitRate=" + ti .maxBitRate 

+ "]"; 
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Ms m Item 

/* 

* @ (#)MsmItem. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM. Sun. isg. smcjc; 

public abstract class Msmltem { 
/ ★ * 

* The nuinber of milliseconds allocated to this item. 

* / 

public long i temDuration; 
/** 

* Time of initial play that may be sacrificed to absorb 
previous schedule 

* slips. Silently limited to itemDuration . If 
TIME_CURRENT, 

* itemDuration . is used. 
*/ 

public long joinlnDuration; 

} 
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MsmTitleltem 

/* 

* @ (#) MsmTitleltem. j a va 
★ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM. Sun . isg . smcjc; 
/* . - * 



* A playlist title item. 
V 

20 public class MsmTitleltem extends Msmltem { 
/** 

* The number of milliseconds into title where play should 
begin. It is 

* illegal for this to be greater than the total play time of 
25 the title. 

*/ 

public long startOffset; 



/** 

* The number of milliseconds of title to play within this 
item. 

* Values less than itemDuration allow some pad for absorbing 
admission 

* delays (and the play truncation that would occur) , but 
35 should admission 

* delay be zero, dead air would occur for the remainder of 
the item. It 

* is illegal for playDuration to be greater than 
itemDuration or for 

* playDuration + startOffset to be greater than the total 
play time of 

* .the title. If TIME_CURRENT, the min of itemDuration and 
total play time 

* minus startOffset is used. 
*/ 

public long playDuration; 
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* The file pathname for title 
*/ 

public String titleName; 

5 

/** 

title'on 9n ° red ° n MsmP1 ^-^tPlaylist. Returns max bit rate of 

* MsmPlayer .getPlaylist. 

w * / 

public int maxBitRate; 
/** 

" if action 11 "' t8rminate * L *y itemDuration seconds (even 

completed) ayS i? aVeiCaUSed SChedUle t0 S1± P and has not 

schedule*^*' alWayS Play ireraDuration seconds of title, allow 
20 * slip if necessary. 

V 

public boolean isTimeLocked; 
/** 

if requited" 6 ' Cl ° SeSt available s P^d in same direction 

towara^rti 3 ^ * Vailabie - *~rch *>r closest is proceeds 
rate : n preSentation «te. Play is skipped if normal presentation 

skipped^' 1011 15 aVailable - If 'alse, play of title is 

* appropriate speed is not available. 
/ 

public boolean playClosestSpeed; 

star^fs'e't^ 1 ^ 16 " 6 " 1 ^^ 1119 "tleName, long itemDuration, long 
long playDuration, long joinlnDuration, 
Tnl ^xBuSeTf b ° OUan "^"<— Speed, 
this. titleName = titleName; 
this.itemDuration = itemDuration; 
4s this. startOff set = startOf f set; 

this. playDuration = playDuration; 
this. joinlnDuration = joinlnDuration; 
this.isTimeLocked = isTimeLocked; 
this. playClosestSpeed = playClosestSpeed; 
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this -maxBitRate = maxBitRate; 

} 

5 MsmTitleltemfXdrBlock xdr) { 

titleName = xdr . xdrinStr ing ( ) ; 

itemDuration = xdr - xdrinMsmTime { ) ; 

startOffset = xdr . xdrinMsmTime () ; 

playDuration = xdr . xdrinMsmTime () ; 
10 joinlnDuration - xdr . xdr inMsmTime ( ) ; 

isTimeLocked = xdr . xdrinBoolean () ; 

playClosestSpeed = xdr . xdrinBoolean () ; 

maxBitRate - xdr . xdrinlnt ( ) ; 

} 

15 

void xdrout (XdrBlock xdr) { 
xdr . xdroutString (titleName) ; 
xdr . xdroutMsmTime (itemDuration) ; 
xdr .xdroutMsmTime (startOffset) ; 

20 

xdr . xdroutMsmTime (playDuration) ; 
xdr .xdroutMsmTime (joinlnDuration) ; 
xdr . xdroutBoolean ( isTimeLocked) ; 
xdr .xdroutBoolean (playClosestSpeed) ; 
xdr . xdrout Int (maxBitRate) ; 



public String toStringO ( 
return MsmToString . titlel temToString ( this ) ; 
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Msm Dead Air-Item 
/* 



* @ (#) MsmDeadAirltem. java 
+ 

^ -Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 



* version 1.0 

* author Christopher Lindblad 



*/ 



package COM.Sun.isg.smcjc; 

public class MsmDeadAirltem extends Msmltem { 

{ public MsmDeadAirltemdong itemDuration, long' joinlnDurationj 

this. itemDuration = itemDuration; 
thisooinlnDuration = joinlnDurat ion; 



MsmDeadAirltem (XdrBlock xdr) { 
25 itemDuration = xdr . xdrinMsmTime { ) ; 

^jomlnDuration = xdr . xdrinMsmTime () ; 

void xdrout (XdrBlock xdr) { 
so xdr .xdroutMsmTime (itemDuration) ; 

^xdr .xdroutMsmTime ( joinlnDura tion) ; 

public String toStringf) { 
3 * ^ return MsmToString . deadAir I temToString ( this) ; 
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MsmException 

/* 

* @ (#) MsmException. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM.Sun.isg. smcjc; 
import java.io.*; * 



j ★ * 

* Signals that an Media Stream Manager exception has occurred. 
*/ 

public class MsmException extends IOException { 

* Constructs an MsmException with no detail message. 
25 * A detail message is a String that describes this 

particular exception . 
*/ 

MsmException ( ) { 
super ( ) ; 

} 



/* + 

* Constructs an MsmException with the specified detail 
message . 

* A detail message is a String that describes this 
particular exception. 

* @param s the detail message 
V 

40 MsmException (String s) { 

super ( s ) ; 

} 

MsmException (int proc, String msg) { 
45 super ( ( (proc >= 0 && proc < procNames . length ) ? 

procNames [proc] : Integer . toSt ring (proc) ) 

msg) ; 

> 

so 



55 



BNSOOaDr<£P_pe0382eAiX> 



61 



EP O 803 826 A2 



10 



20 



25 



35 



40 



50 



MsmException (int proc, int err) { 

super ( ( (proc >= 0 proc < procNames . length) ? 

procNames [proc] : Integer . toString (proc) ) 
+ ... .. + 

((err >= 0 && err < errNames . length) ? 
^ errNames [err] : Integer . toString (err ))) ; 



private static final String [] procNames = ( 
"null", 
"server authtype" , 
"player create", 
15 "player delete", 

"player list", 
"player access set", 
"player access get", 
"player persistence set", 
"player persistence get", 
"player playlist set", 
"player playlist get", 
"player connect set", 
"player connect get", 
"player play", 
"player pause", 
"player resume", 
"player play status", 
30 "title status", 

}; 

private static final String [] errNames = { 
"success", /* o */ 



"failed", /* 1 */ 

"badarg", /+ 2 */ 

"no mem" , /* 3 */ 

"no netname", /+ 4 +/ 

"des auth failed", /* 5 */ 

"kerb auth failed", /* 6 +/ 

"no such player", /+ 7 */ 

"old modstamp", /* 8 */ 

"item overlap", /* 9 */ 

45 "bad speed", / + 10 */ 

"bad start date", /* 11 */ 

"not connected", /* 12 */ 
"bad pause position", /* 13 */ 

"play active", /* 14 */ 
"bad file name", /* 15 */' 

"bad mfs file", /* 16 */ 
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"bad file type", /* 17 */ 
"info too long", /* 18 */ 
5 "a.uth failed"/- /* 19 */ 

"bad position", /+ 20 */ 

"kerberos unsupported", /* 21 */ 
"bad credentials", /* 22 */ 
"insufficient authorization", /* 23 */ 
10 "bad access op", /+ 24 */ 

"bad access type", /+ 25 */ 
"bad persist type", /* 26 */ 
"bad time arg", /* 27 */ 

"bad start position", /* 28 */ 
"bad duration", /* 29 */ 

"bad start offset", /* 30 */ 
"bad edit stast pos", /* 31 V 
"bad edit duration", /* 32 */ 

"bad list start pos", /* 33 */ 
"bad item duration", /+ 34 V 

"bad join in duration", /* 35 */ 
"bad play duration", /* 36 */ 

"bad item type", /* 37 */ 
25 "bad title type", /*' 38 */ 

"no such file", /* 39 */ 

"bad lut file", /* 40 */ 

"bad mfs fs", /* 41 */ 

"toe syntax", /+ 42 */ 

"toe eof", /* 43 */ 

"toe bad char", /* 44 V 

"no normal speed", /* 45 */ 
"dup speeds", /+ 4 6 +/ 

as "bad file len", /* 47 */ 

"toe incomplete", /* 48 */ 
"toe can't map", /* 49 +/ 
"toe bad filesize", /* 50 */ 
"toe bad index", /* 51 */ 
"too low connect rate", /* 52 */ 
}; 
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XdrBlock 

/* 

* @ (#) XdrBlock. java 



Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 



* version 1.0 

* author Christopher Lindblad 



*/ 

package COM . Sun . isg . smcj c ; 

import java.io.*; ^ 
import java.net.*; 

/** 

Used to manipulate ONC RPC calls and replies, 



*/ 

class XdrBlock { 
byte [ ] buf ; 
25 int ptr; 

/* 

* Create a new empty block. 

* Sparam size The size of the block. 
30 */ 

public XdrBlock (int size) { 
buf = new byte [size]; 

} 

35 /* 

* Create a new empty block. 
*/ 

public XdrBlock () { 
this (256) ; 

} 



/* 
+ 



Create a new block and initialize it with a call header, 

* @param prog The RPC program number. 

* @param vers The RPC version number. 

* @param proc The RPC procedure number. 

* @return The xid generated. 
*/ 
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public XdrBlock (int prog, int vers, int proc) { 
this () ; 

xdroutCallHeader (prog, vers, proc) ; 

> 

/** 

* Create a new block and receive it from an InputStream. 

* @param is The InputStream from which to receive the block. 
"* Gexception IOException If an 10 error has occurred. 

*/ 

public XdrBlock ( InputStream is) throws IOException { 
synchronized (is) { 
is int hdr; 

do { 

hdr - readByte ( is) << 24; 
hdr |= readByte(is) << 16; 
hdr |= readByte(is) << 8; 
hdr |= readByte(is) 
int start; 

int count = hdr & 0x7fffffff; 
if (buf == null) { 
start = 0 ; 

buf = new byte [count]; 
} else { 

start = buf. length; 

byte[) tmp = new byte (start + count]; 
System. arraycopy (buf , 0, tmp, 0, start); 
buf = tmp; 

} 

while (count > 0 ) { 

int done = is.read(buf, start, count); 
if (done < 0) throw new IOException ( "end of file"); 
start += done; 
count -= done; 

} 

} while ({hdr & 0x80000000) == 0); 
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) 

) 

private int readByte ( InputStream is) throws IOException { 
int result = is.readO; 

if (result < 0) throw new IOException ( "end of file"); 
return result ; 



/** 

* Send the block to an output stream. 
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* @paraia is The OutputStream ro which to send the block. 

* @exception IOException If an 10 error has occurred. 
V 

public synchronized void send (OutputStream os) throws 
IOException { 

int hdr = ptr | 0x80000000; 
synchronized (os) { 

& 
& 
& 
& 



os, write ( (hdr >> 24 

os .write ( (hdr >> 16 

os .write ( (hdr » 
os ..write ( (hdr 

os .write (buf, 0, 



8) 



Oxf f ) 
Oxff ) 
Oxff ) 
Oxff) 



ptr) ; 

if (os instanceof 3uf f eredOutputStream) 

( (Buff eredOutputStream) os) . flush () ; 
} - * 



{ 
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/** 

* Input a fixed-length array of bytes from the block. 

* Sparam len The lenght of the array. 

* @return The byte array. 
*/ 

public synchronized byte[] xdrinBytes ( int len) { 
byte[] result = new byte[len]; 
System. arraycopy (buf , ptr, result, 0, len) / 
ptr = (ptr + len + 3) & -4; 
return result; 

} 



35 



40 



* Input a variable-length array of bytes from the block. 

* @return The byte array. 
*/ 

public synchronized byte [] xdrinBytes {) { 
return xdrinBytes ( xdrinlnt 0) ; 

} 



45. 



50 



/ * ★ 

* Input an int from the block. 

* @return The int. 
V 

public synchronized int xdrinlnt () { 
int result; 

result = (buf[ptr ] & Oxff) << 24 
result 1= (buf[ptr + 1] & Oxff) << 16 
result |= (buf[ptr + 2] & Oxff) « 8 
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result |= (buffptr + 3] & Oxf f ) ; 
ptr += 4; 
5 return result; 

} 

/** 

* Input an boolean from the block. 
10 * @return The boolean. 

*/ 

public boolean xdrinBoolean ( ) { 
return xdrinlnt() != 0; 

} 

is 

/** 

* Input a String from the block. 

* @return The String. 
*/ 

20 public String xdrinStr ing ( } { 

return new String (xdrinBytes () , 0) ; 

\ 



/** 

* Input a Media Stream Manager Time value 
*/ 

public synchronized long xdrinMsmTime ( ) { 
long sec = xdrinlntf); 
long nsec = xdrinlntO; 

if (sec == nsec && sec < 0) return sec; 
return sec* 1 0OO000000L + nsec; 

} 



* Output a fixed-length array of bytes to the block. 

* @param val The array to output. 

* Sparam len The length of the array to output. 
*/ 

40 public synchronized void xdroutBytes (byte [ ] val, int len) ( 

int nxt = (ptr + len + 3) & -4; 
if (nxt > buf. length) grow(nxt); 
System. arraycopy (val, 0, buf, ptr, len); 
ptr = nxt; 



/** 

* Output a variable-length array of bytes to the block. 

* @param val The array to output. 
V 
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public synchronized void xdroutBytes (byte [ ] val) { 
int len = val. length; 
xdroutlnt (len) ; 
xdroutBytes (val, len) ; 

} 

/** 

* Output an int to the block. 

* @param val The int to output. 
V 

public synchronized void xdroutlnt ( int val) { 
int nxt = ptr + 4; 
if (nxt > buf. length) grow (nxt) ; 
buffptr ] = (byte) ( (val » 24) & Oxff) 
buf [ptr + 1] = (byte) ((val » 16) & Oxff) 
buffptr + 2] = (byte) ( (val » 8) & Oxff) 
buf [ptr + 3] = (byte) ( (val ) & Oxff) 

ptr = nxt; 

} 



/ 



* Output an boolean to the block. 
25 * @param val The boolean to output. 

V . 
public void xdroutBoolean (boolean val) { 
xdroutlnt (val? 1:0); 

} 



/** 

* Output a String to the block. 

* @param val The String to output. 
V 

public void xdroutString (String val) { 
int len = val . length () ; 
byte[] tmp = new byte[len]; 
val.getBytesfO, len, tmp, 0) ; 
40 xdroutBytes (tmp) ; 

} 

/** 

* Output a Media Stream Manager Time value 

* @param val The time to output 
V 

public synchronized void xdroutMsmTime ( long val) 
if (val < 0) { 
50 xdroutlnt ( (int) val) ; 

xdroutlnt ( (int) val) ; 
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} else { 

xdroutlnt ( (int) ( val/lOOOOOOOOOL) ) ; 
xdroutlnt ( (int) ( val%1000000000L) ) ; 

} 

} 

private void grow (int needed) { 
int len « buf . length*2 ; 
while (len < needed) len *= 2; 
byte[] tmp = new byte [len]; 

System. arraycopy (buf , 0, tmp, 0, buf. length); 
buf = tmp; 

} 



/** * 

* Output a RPC Call header to the block. 

* @param prog The RPC program number. 
20 * @param vers The RPC version number. 

* @param proc The RPC procedure number. 
*/ 

public synchronized void xdroutCallHeader (int prog, int vers, 
int proc) { 
25 xdroutlnt (genXid () ) ; 

xdroutlnt (CALL) ; 
xdroutlnt (RPCVERS) ; 
xdroutlnt (prog) ; 
xdroutlnt (vers) ; 
xdroutlnt (proc) ; 
xdroutlnt (AUTH__UNIX) ; 
xdroutBytes (credO ) ; 
xdroutlnt (AUTH_NULL) ; 
xdroutBytes (verf ( ) ) ; 



} 



public synchronized int callXidO { 
int tmp = ptr; 
40 ptr = 0; 

int result ~ xdrinlntO; 
ptr = tmp; 
return result; 

} 



50 



public synchronized int callProcO { 
int tmp = ptr; 
ptr = 20; 

int result = xdrinlntO; 
ptr = tmp; 
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return result; 

} 

private static int lastxid = 0; 

private synchronized static int genXidO f 
if (lastXid != 0) lastXid += 1; 

else lastXid = (int ) (Math. random ( ) * 2147483648 OD) * 



io return lastXid; 

} 



private static byte[] lastCred; 



private synchronized static byte [] cred ( ) f 
if (lastCred « null) { 1 
XdrBlock xdr = new XdrBlockf); 

Strln^c^f ( Unt) (System - cur ^tTimeHillis ( ) /1000L) ) ; 

raLto° S m I Ine 5 Address ^ etLocaiHos t().getHostNaine(); 
catch (UnknownHostException e) host - «w. 
xdr. xdroutString (host) ; ' 
int uid; 
try uid = 

Integer. parselnt (System. getProperty ("user. uid" ) ) - 
catch (NumberFormatException e) uid = o- 
xdr .xdroutlnt (uid) ; 
int gid; 
try gid = 

Integer. parselnt (System. getProperty ("user. gid") ); 

catch (NumberFormatException e) gid = o' 
xdr .xdroutlnt (gid) ; 
xdr. xdroutlnt (0) ; // no gids 
35 lastCred = new byte [xdr . Dtr] ; 

^ System. arraycopy (xdr. buf^ 0, lastCred, 0, xdr.ptr); 

return lastCred; 

} 



private static byte [ ] lastVerf; 

private synchronized static bytef] verff] i 
if (lastVerf == null) { 
^ lastVerf = new byte[0]; 

return lastVerf; 

} 
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/** 

* Input a RPC reply header from the block. 

* @param xid The expected xid. 

5 * (^exception IOException If an error has occurred. 

V 

public synchronized void xdrinReplyHeader ( int xid) throws 
IOException { 

int replyXid = xdrinlntO; 
w if (replyXid != xid) { 

throw new IOException ( 
"rpc xid mismatch: " + 

"expected " + xid + " but got " + replyXid) ; 

} 

is int msgType = xdrinlntO; 

if (msgType „!=^ REPLY) { 

throw new IOException ( 
"rpc msg type mismatch: " + 

" expected " + REPLY + " but got " + msgType) ; 

20 } 

int replyStat = xdrinlntO; 
switch (replyStat) { 
case MSG_ACCEPTED: 

int verfType = xdrinlntO; 
25 byte [ ] verf = xdrinBytes () ; 

int acceptStat = xdrinlntO; 
switch (acceptStat) { 
case SUCCESS: 
return; 
case PROG_UNAVAIL: 
throw new IOException ( 
"rpc accepted: " + 

"remote hasn't exported program"); 
35 case PROG_MISMATCH: 

int low = xdrinlntO; 
int high = xdrinlntO; 
throw new IOException ( 
"rpc accepted: " + 
40 "version mismatch low= M + low + " high=" + high) ; 

case PROC_UNAVAIL: 
throw new IOException ( 
"rpc accepted: " + 

"program can't support procedure") ; 
45 case GARBAGE_ARGS : 

throw new IOException ( 
,f rpc accepted: " + 
"procedure can't decode params"); 
default : 
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throw new IOException( 
"rpc accepted: " + 
"unknown status: " + acceptStat) ; 

5 } 

case MSG_DENIED: 

int rejectStat = xdrinlntO; 
switch (rejectStat) { 
case RPC_MISMATCH: 
io int low = xdrinlntO ; 

int high = xdrinlntO; 
throw new IOException( 
"rpc rejected: " + 

"version mismatch low=" + low + " high=" + high) 
>s case AUTH_ERROR: 

int authStat = xdrinlntO; 
switch (authStat) { 
case AUTH_BADCRED: 

throw new IOException( 
"rpc rejected: " + 

"remote can't authenticate caller: " + 
"bad credentials (seal broken)"); 
case AUTH_RE JECTEDCRED : 

throw new IOException( 
"rpc rejected: " + 

"remote can't authenticate caller: " + 
"client must begin new session") ; 
case AUTH_BADVERF: 

throw new IOException( 
"rpc rejected: " + 

"remote can't authenticate caller: " + 
"bad verifier (seal broken)"); 
case AUTH_RE JECTEDVERF : 

throw new IOException( 
"rpc rejected: " + 

"remote can't authenticate caller: " + 
"verifier expired or replayed"); 
case AUTH_TOOWEAK : 

throw new IOException( 
"rpc rejected: " + 

"remote can't authenticate caller: " + 
"rejected for security reasons") ; 
default: 

45 throw new IOException( 

"rpc rejected: " + 

"remote can't authenticate caller: " + 
"unknown status: " + authStat); 

50 
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default: 
throw new IOException ( 
"rpc rejected: " + 
"unknown status: " + rejectStat) ; 

} 

default: 

throw new IOException ( "unknown rpc reply status: " + 
replyStat ) ; 
} 

} 

/* 

* Blow up if ptr hasn't reached the end of the block. 
*/ 

public void dor\e ( ) throws IOException { 
if (ptr != buf. length) { 
throw new IOException ( 
(buf . length-ptr) + " extra bytes of data remaining in 

reply") ; 
} 

} 

/* 

* Provisions for authentication of caller to service and 
vice-versa are 

* provided as a part of the RPC protocol. The call message 
has two 

* authentication fields, the credentials and verifier. The 

reply 

* message has one authentication field, the response 
verifier. The RPC 

* protocol specification defines all three fields to be the 
following 

+ opaque type (in the external Data Representation (XDR) 
language [9] ) : 



*/ 

private static final int AUTH_NULL 

private static final int AUTH_UNIX 

private static final int AUTH_SHORT 

private static final int AUTH DES 



45 



/* 

* RPC Message protocol version 2 
*/ 

private static final int RPCVERS = 2 

private static final int CALL = 0 

private static final int REPLY = 1 
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/* 

* A reply to a call message can take on two forms; The 
message was 

* either accepted or rejected. 
*/ 

private static final int MSG_ACCEPTED = 0; 
private static final int MSG_DEN1ED = l; 

/* 

* Given that a call message was accepted, the following is 
the status 

* of an attempt to call a remote procedure. 
V 

private static final int SUCCESS = 0; 

private static *final int PROGJJNAVAIL = 1; 
private static final int PROG_MISMATCH = 2; 
private static final int PROCJJNAVAIL = 3; 
private static final int GARBAGE ARGS = 4; 



20 



* Reasons why a call message was rejected: 



25 



private static final int RPC_MISMATCH = 0; 
private static final int AUTH ERROR « 1; 
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/* 

* Why authentication failed: 
*/ 

private static final int AUTH_BADCRED 

private static final int AUTH_RE JECTEDCRED = 

private static final int AUTH_BADVERF = 

private static final int AUTH_RE JECTEDVERF = 

private static final int AUTH TOOWEAK 



1; 
2; 
3; 
4; 
5; 
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PortMapper 

/* 

* @ ( # ) PortMapper . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM . Sun . isg . smcj c; 

import java.io.*; * 
import j ava . net . * ; 

/** 

* Interface to the ONC oort mapper. 
*/ 

class PortMapper { 

private Socket socket; 
private InputStream is; 
private OutputStream os; 

/** 

* Create a port mapper client. 

* Oparam host The server for which we want to know the port 
mappings . 

* @exc.eption IOException If there is an error. 
V 

public PortMapper (String host) throws IOException { 
socket = new Socket (host, PMAP__P0RT) ; 

is = new Buff eredlnputS tream (socket . getlnputStream ()) ; 
os = new Buf f eredOutputStream (socket . getOutputStream ()) ; 

} 

/ + + 

* Get -the port number for a particular ONC service. 

* Sparam prog The R?C program number. 

* Sparam vers The RPC version number. 

* @param prot Either IPPROTO_TCP or IPPROTOJJDP. 

* Sreturn The port number for the service. 

* @exception IOException If there is an error. 
V 

public synchronized int get?ort(int prog, int vers, int prot) 
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throws IOException { 

XdrBlock call = new XdrBlockO; 
call . xdroutCallHeader ( PMAP_PROG, PMAP_VERS, 
PMAPPROC_GETPORT) ; 

call . xdroutlnt (prog) ; 
call .xdroutlnt (vers) ; 
call . xdroutlnt (prot) ; 
call . xdroutlnt (0) ; 
call . send (os) ; 

XdrBlock reply = new XdrBlock ( is ) ; 
reply . xdrinReplyHeader (call . callXid ( ) ) ; 
int result = reply . xdrinlnt () ; 
reply . done ( ) ; 
return result; 

} 



20 



/** 

* Closes the port mapper. 
*/ 

public synchronized void close () throws IOException 
socket . close { ) ; 

} 



25 



static final int IPPROTOJTCP = 6; 
static final int IPPROTO UDP = 17; 
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private static final int PMAP_PR0G = 100000; 
private static final int PMAP__VERS = 2; 
private static final int PMAP PORT = 111; 



35 



private static final int PMAPPROC NULL 



private static 
private static 
private static 
private static 
orivate static 



final int PMAPPROC_SET 

final int PMAPPROC_UNSET 

final int PMAP PR0C_GET PORT 

final int PMAPPROC_DUMP 

final int PMAPPROC CALLIT 
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Decoder 

/* 

* @ (#) Decoder . java 
★ 

* Copyright 1995 Sun Microsystems, Inc. Ail Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
■* 

*/ 

package COM. Sun. isg . smcjc; 

import java.awt.*; * 
import java.io.*; 

public class Decoder extends Panel { 
private Decoderlmpl impl; 

public Decoder () { 
setLayout (new BorderLayout ( ) ) ; 

} 



public synchronized void init (String format/ Image img, String 
host f int port, String ATM) 
throws IOException { 
try { 

30 Class implClass = Class . forName (implClassName (format) ) ; 

if (impl == null I I impl . getClass ( ) != implClass) { 
removeAll ( ) ; 

impl - (Decoder Impl ) implClass . newlnstance () ; 
add { "Center", impl) ; 

35 } 

impl . init (format, img, host, port, ATM); 
} catch (ClassNotFoundException e) 

throw new IOException (e . toString ( ) 
) catch ( IllegalAccessException e) 

throw new IOException (e . toString ( ) 
) catch ( InstantiationException e) 
throw new IOException (e . toString ( ) 



1 

public synchronized void paint (Graphics g) { 
if (impl != null) super . paint (g) ; 
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else { 

Rectangle b = bounds () ; 
g. set Co lor ( get Background ( ) ) ; 

g. f ill3DRect (0, 0, b. width, b. height, true); 

} 

} 

public synchronized void stopO throws lOException { 
if (impl I= null) impl . stop () ; 

} 

public synchronized void pause () throws lOException { 
if (impl != null) impl .pause {) ; 

} 

public synchronized void play() throws lOException { 
if (impl != null) impl. play (); 

} 

public synchronized void flush () throws lOException { 
if (impl != null) impl . flush () ; 

} 

public synchronized String destTiAddr() throws lOException { 
if (impl != null) return impl . destTiAddr ( ) ; 
return ""; 

} 

public synchronized String encap ( ) throws lOException { 
if (impl != null) return impl . encap () ; 
return " "; 

) 

/** 

* A hacky implementation factory 
V 

40 private static String implClassName ( String format) throws 

lOException { 

String osArch = System. getProperty ( "os . arch" , "?os . arch" ) ; 
String osName = System. getProperty ( "os . name", " ?os . name" ) ; 
String osVersion = System . getProperty ( "os . version" , 
is " ?os . version" ) ; 

String spec = format + " " + osArch + " " + osName + " " + 
osVersion; 

if (format .equals ("MPEG1SYS") ) { 

if (osName. equals ("Solaris") I I osName . equals ( "SunOS " ) ) 
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if (osArch . equals ( "spare" ) ) { 

return "COM. Sun. isg . srnc j c .MpxDecoderlmpl " ; 

} 

} 

} 

throw new IOException ( "no decoder for M + spec) ; 

} 

} 



Decoderlmpl 

/* 

* @ (#) Decoderlmpl . java 



Copyright 1995 Sun Microsystems, Inc. All Rights Reserved, 



* version 1.0 

* author Christopher Lindblad 



★ 



V 

package COM. Sun. isg. smeje; 

import java.awt.*; * 
import java.io.*; 



abstract class Decoderlmpl extends Canvas { 

public abstract void init (String format/ Image img, String 
host, int port, String ATM) throws IOException; 
35 public abstract void stop() throws IOException; 

public abstract void pause () throws IOException; 
public abstract void playO throws IOException; 
public abstract void flush () throws IOException; 
public abstract String destTiAddrO throws IOException; 
public abstract String encap ( ) throws IOException; 

} 
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MpxDecoderlmpl 

/* 

* @ (#)MpxDecoderImpl. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
+ . 

* version l . 0 

* author Christopher Lindblad 
★ 



V 

15 package COM. Sun . isg . smc j c; 

import j ava . applet ; 
import java.io.*; 
import j ava . awt . * ; 
import j ava . net . * ; 



class MpxDecoderlmpl extends Decoderlmpl implements Runnable { 
private String format; 
private String host; 
private int port; 
private int portO; 
private Image img; 
private long f adeTimeMillis ; 
private DatagramSocket ctrlSckt; 
private Thread thread; 
private DatagramPacket ctrlPckt; 
private File logFile; 
private float luminance = 1.0F; 
private int dataPort; 
private int scale = 1; 
private int state^STOP; 
private boolean multi=false; 
private boolean ATM=false; 
40 private String ATMs=null; 

public MpxDecoderlmpl () { 
super ( ) ; 

} 
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public synchronized void init (String format, Image img, 
String host, int port, String ATMs) 
throws IOException { 

this. format = format; 
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this.img = img; 
ATM=(ATMs!=null) ; 

this . port=port ; 

this . host=host; 

if ( (port==-l)&& ( ! ATM) ) { 
dataPort = genLocalPort ( ) ; 

}else{ 

dataPort = port; 
port0= genLocalPort () ; 
multi= ! ATM; 

if (ATM) this. ATMs = ATMs; 

} 

ctrlPckt = new DatagramPacket ( 
new 

byte [128] , 128, Inet^ddress . getLocalHost ( ) , genLocalPort () ) 
ctrlWord(0, 0x00000001); // sync 



20 



25 



ctrlWord (1, 
ctrlWord (2, 
ctrlWord (3, 
ctrlWord (4, 
ctrlWord (5, 
ctrlWord (6, 
ctrlWord (7, 
ctrlWord (8 r 



0x00000002) ; // 
0x00000003); // 
0x00000004); // 
OxaaaaOOOl) ; // 
OxbbbbOOOl); // 
0x00000000); // 

OxccccOOOO) ; 

OxddddOOOl) ; 



} 



sync 
sync 
sync 

version = 1 
channel = 1 
sequence = 0 
// flags - 0 
// type = 1 



30 



public Dimension minimumSize ( ) { 
return new Dimension (WIDTH, HEIGHT) 

} 



public synchronized Dimension pref erredSize ( ) { 
Dimension dim = new Dimension (WIDTH*scale, ■ HEIGHT*scale) ; 
35 return dim; 

} 

public synchronized void layout () { 
Rectangle b = bounds () ; 
40 double xscale = (double) b . width/ (double) WIDTH; 

double yscale = (double) b . height/ (double) HEIGHT; 
int scale = (int) ( (xscale + yscale) / 2.0 + 0.25); 
if (scale < 1) scale = 1; 
if (scale > 3) scale = 3; 
45 if (scale != this. scale) ( 

this. scale = scale; 

if (state == PAUSE || state == PLAY) updateVideoMode ( ) ; 

} 
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this) 
} 



public synchronized void paint (Graphics g) { 
Dimension ps = pref erredSize ( ) ; 
g . setColor (getBackground ( ) ) ; 

g.fill3DRect (0, 0, ps. width, ps. height, true) ; 
if (img != null) g.drawlmage (img, 0, 0 7 ps. width, ps. height, 



w 



public synchronized void stop() throws IOException 
if (state == PAUSE | | state == PLAY) { 

if (multi I I ATM) { 
15 StringBuffer sc= new StringBuf f er ( ) ; 

sc. append ("kloop "); 
System. out .println (sc. toString ( ) ) ; 

StringU cmdarrayO= new String[3]; 
cmdarrayO [0] = "/bin/sh"; 
20 cmdarrayO [1] = "-c"; 

cmdarray0[2] = sc . toString () ; 
try Runtime. getRuntime () . exec (cmdarrayO) ; 
catch (SecurityException e) 
System, out. println ("Exec="+exec( cmdarrayO [2] ) ) • 
25 ) 

ctrlWord(9, MCMD__EXIT) ; 

ctrlSckt.send(ctrlPckt) ; 
ctrlSckt .close () ; 
30 ctrlSckt = null; 

state = STOP; 
try { 

if (logFile. length () == 0) logFile . delete () ; 
} catch (SecurityException e) { 
35 String cmd = "/bin/rm -f " + logFile . getPath ( ) ; 

try Runtime . getRuntime ( ) . exec (cmd) ; 
catch (SecurityException f) exec (cmd); 



40 



> 

) 



public synchronized void pause ( ) throws IOException f 
if (state == PLAY) { 1 
ctrlWord(9, MCMD_PLAYCTR) ; // identifier 

45 ctrlWorddO, PC_PAUSE); // action 

ctrlWorddl, Float . f loatToIntBits ( 1 . OF) ) ; // soeed 
ctrlSckt. send(ctrlPckt) ; 
state = PAUSE; 

} 

50 



55 



BN80OCID: <£P_pe038aoA2JL> 



82 



EP 0 803 826 A2 



30 



35 



} 



public synchronized void playO throws IOException { 
5 if (state == PAUSE) ( 

ctrlWord{9, MCMD_PLAYCTR) ; // identifier 

ctrlWord(10, PC_PLAY) ; // action 
ctrlWorddl, Float . f loatToIntBits ( 1 . OF) ) ; // speed 
ctrlSckt .send(ctrlPckt) ; 
w state = PLAY; 

) else if (state == STOP) { 

StringBuffer sb = new StringBuf f er ( ) ; 
sb. append ( "exec mpx") ; 
if (imulti) { 
75 if ( ! ATM) { 

sfcv append ( " -fn udp,lp,"); 
sb . append (dataPort) ; 
}else{ 

sb. append (" -fn udp,lp," ); 
20 sb . append (portO) ; 

> 

}else[ 

sb. append (" -fn udp/lp,' 1 J^- 
sb . append (port 0 ) ; 

25 , 

sb. append (" -xn udp,lp, M ); 
sb. append (Ctrl Pckt . get Port {) ) ; 
sb. append ( " -u 2") ; 
sb. append (" -v " ) ; 

int depth = getColorModel ( ) . getPixelSize ( ) ; 
if (depth ==1) { 

sb . append ( "mono" ) ; 
} else { 
sb. append ( "col" ) ; 
sb . append (depth) ; 
if (depth 24 && scale > 1) sb. append ( "B" ) ; 

} 

sb. append ( " , ) ; 
40 sb. append (scale) ; 

sb. append ( " -w " ) ; 

sb . append ( windowld ( ) ) ; 

sb. append (" </dev/null " ) ; 

sb. append ( >" ) ; 
45 System. out .print In (sb. toString( ) ) ; 

logFile = new 
File ( M /tmp/mpx. "+System. currentTimeMillis () ) ; 

sb. append (logFile. getPath ( ) ) ; 

sb. append (" 2>&1") ; 

50 
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String [] cmdarray = new String [3]; 
cmdarraytO] = Vbin/sh"; 
cmdarray [1] = "-c"; 
cmdarray [2] = sb. toString ( ) / 
try Runtime * getRuntime ( ) - exec (cmdarray) ; 
catch (SecurityException e) exec (cmdarray [2] ) ; 
ctrlSckt = new DatagramSocket ( ) ; 
state = PLAY; 
if (ATM) { 

StringBuffer sc= new S tringBuf f er ( ) ; 
sc. append ( 11 loop a " ); 
sc. append (dataPortV " ) ; 
sc . append (portO-*-" >sasa &"); 
System. out . print In (sc. toString ( ) ) ; 

StringU. cmdarrayO= new String[3]; 
cmdarrayO [0] = "/bin/sh"; 
cmdarrayO [1] = "-c"; 
cmdarray0[2] = sc . toString () ; 
try Runtime . getRuntime ( ) . exec (cmdarrayO) ; 
catch (SecurityException e) 
System. out . print In ( "Exec="+exec (cmdarrayO [2] ) ) ; 
}else if (multi) { 

StringBuffer sc= new StringBuf f er ( ) ; 
sc. append ("loop m "); 
sc . append (host+" " ) ; 
sc. append (dataPort+" " ) ; 
sc. append (portO+" &") ; 
System. out .println (sc . toString ( ) ) ; 

Stringf] cmdarrayO= new String[3J; 
cmdarrayO [0] = Vbin/sh"; 
cmdarrayO[l] = "-c"; 
cmdarray0[2] = sc . toString () ; 
try Runtime . getRuntime ( ) . exec (cmdarrayO) ; 
catch (SecurityException e) 
System. out .println ( "Exec=" + exec (cmdarrayO [ 2 ] ) ) ; 
} 

} 

} 

public synchronized void flush () { 
if (thread == null) ( 

thread = new Thread (this) ; 
thread. start ( ) ; 

> 

f adeTimeMillis = System. currentTimeMillis ( ) + 4000; 

} 
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public synchronized String destTiAddr ( ) throws 
UnknownHostException { 
String phost; 
//return "beO, "+phost+", "+dataPort; 
if (ATM) { 

return "port= M + ATMs + ",vc= ,f + dataPort; 
}else { 

phost = InetAddress . getLocalHost ( ) . getHostName ( ) ; 
return "host=" + phost + " / udpport=" + dataPort; 

} 

} 

public String encapO { 
return "MPEG1SYS"; 



private void ctrlWord(int idx, int val) { 
byte[] buf = ctrlPckt . getData ( ) ; 

buf[idx*4 ] = (byte) ((val >> 24) & Oxff) 

buf[idx*4 + 1] = (byte) ((val » 16) & Oxff) 

buffidxM + 2J = (byte) ((val » 8) & Oxff) 

buf[idx*4 + 3] = (byte) ((val ) & Oxff) 

} 



private void updateVideoMbde ( ) { 
ctrlWord(9, MCMD_PRESCTR) ; // identifier 
ctrlWorddO, PCTR_VMD | PCTR_LUM) ; // which 
int depth = getColorModel ( ) . getPixelSize ( ) ; 
int col = (depth~D? 0 : (depth==24&&scale>l ) 
VDM_C0L; 

(col«8) I scale) ; // video mode 
0) ; // audio mode 

0) ; // audio_volume 

Float. f loatToIntBits (luminance) ) ; // 
0) ; // saturation 

0) ; // gamma 

send (ctrlPckt ) ; catch (IOException e) 



? VDM COLB 



ctrlWord (11, 
ctrlWord(12 / 
ctrlWord (13, 
ctrlWord(14 / 
ctrlWord (15, 
ctrlWord(16, 
try ctrlSckt. 



luminance 



} 



public synchronized void run ( ) { 
Thread currentThread = Thread . currentThread () ; 
try { 

while (currentThread==thread && ( state==PAUSE I I 
state==PLAY) ) { 

long currentTimeMillis = System. currentTimeMillis () ; 
float last = luminance; 

if ( f adeTimeMillis < currentTimeMillis) ( 
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if (luminance < 1.0F) luminance += 0.125F; 
} else { 

if (luminance > 0.0F) luminance -= 0.125F; 

if (luminance != last) updateVideoMode { ) ; 
if (luminance >= 1.0F) return; 

try wait (125); catch ( InterruptedExcept ion e) ; 



} finally { 

if (thread == currentThread) thread = null; 

} 

} 

private int genLocalPort ( ) throws IOException { 
DatagramSocket sckt = new DatagramSocket () ; 
int port = sckt . getLocalPort () ; 
sckt . close ( ) ; 
return port; 

} 

private native int windowIdO; 

private native int exec (String cmd) ; 

protected void finalize () { 
try stop(); catch (IOException e) ; 

} 

private static final int WIDTH = 352; 
private static final int HEIGHT = 240; 

private static final int STOP = 0; 
private static final int PLAY = 1; 
private static final int PAUSE = 2; 



/* command identifiers */ 
private static final int MCMD_NULL 
private static final int MCMD_EXIT 
private static final int MCMD_OPENSRC 
private static final int MCMD_CLOSESRC 
private static final int MCMD_REENTER 
private static final int MCMD_PLAYCTR 
private static final int MCMD_PRESCTR 
private static final int MCMD_STREAM 
private static final int MCMD_S ENDS TAT 
private static final int MCMD_S TAT US 
private static final int MCMD ACK 



0, 
1, 
2 i 
3, 
4, 
5, 
6, 
7, 
8, 
9, 
10; 
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/* command flags * / 

private static final int MCFL_SNDACK 
private static final int MCFLjDRGMPX 

/* command parameter values: */ 



= (1«0); 
= (1«2) ; 



/* source type 



MCMD OPENSRC */ 



private static final int MSC_FNAME 

private static final int MSC_FDSCP 

/* flags : MCMD_REENTER */ 

private static final int MRE_FOFS 

private static final int MRE_ASOPEN 
private static 4 final int MRE_STRMS 

private static final int MRE SEEKVSEQ 



= 1; 
= 4; 



= (1«0) 

= (1«2) 

= (1«3) 

= (1«4) 



/* data type 



MCMD OPENSRC, MCMD REENTER */ 



private static final int BSTRM_11172 
private static final int BSTRM_VSEQ 
private static final int BSTRM ASEQ 



/* action 



MCMD PLAYCTR */ 



private static final int PC_PLAY 

private static final int PC_FWDSPEED 

private static final int PC__FWDSTEP 

private static final int PC PAUSE 



/* which : 

private static final 

private static final 

private static final 

private static final 

private static final 

private static final 



MCMD_PRESCTR +/ 
int PCTR_VMD 
int PCTR_AMD 
int PCTR_AVOL 
int PCTR_LUM 
int PCTR_SAT 
int PCTR GAM 



MCMD PRESCTR 



/* video_mode : 

* Oxvvzz "™ 

* vv : VDM_COL, VDM__COLB 

* 22 : zoom [1-3] 
V 

private static final int VDM_COL 
private static final int VDM~COLB 



/* audio_mode 
* cccqqq 



MCMD PRESCTR 



= (1«0) 
= (1«1) 
= (1«2) 



(1«0) 
(1«D 
(1«2) 
(1«3) 



(1«0) 

(1«1) 
(1«2) 
(1«3) 
(1«4) 
(1«5) 



1; 
2; 
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4r 


ccc : 


channel listening selection 


* 


Sxx 


: 1/0 -> Selection/ No Selection 


* 


101 


: Left 


* 


110 


: Right 


* 


111 


: Left & Right 


* 


qqq: 


audio playback quality selection 




Sxx 


: 1/0 -> Selection/ No Selection 




100 


: High 


+ 


101 


: Medium 




110 


: Low 


*/ 







15 



20 



25 



40 



/* stream : MCMD_STREAM, MCMD_OPENSRC, MCMD_REENTER 



★ 



stream, 



30 stream, 



35 * / 



vvvvvvvv . ^aaaaaaa 
aaaaaaaa: 

a7 : i-> ignore stream identifier part (bits aS-aO) 

a6: audio stream subscription 0/ON, 1/OFF 

a5: l->auto subscribe to first encountered audio 

(a4-a0 = 00000) . 
a4-a0: subscribe to a particular audio stream [0-31] 

vvvvvvvv : 

v7 : i-> ignore stream identifier part, bits v5-v0 

v6: video stream subscription 0/ON, 1/OFF 

v5: l->auto subscribe to first encountered video 

(v4-v0 = 00000) . 
v4 : 0 

v3-v0: subscribe to particular video stream [0-15] 



private static final int S TRM_IGNORE I D = 0x80 
private static final int STRM_SBCOFF = 0x40 

private static final int STRM_AUTOSBC = 0x20 

static { 

try System. loadLibrary ("javampx") ; catch 
(Unsatisf iedLinkError e) 
45 ^ System, load < Vopt/SUNWsmcj c/lib/ lib j avampx . so") ; 

) 



50 
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smcrm 

/* 

s * @ (#) smcrm. java 

★ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

■Ir 

* version 1.0 

>o * author Christopher Lindblad 



15 



20 



35 



40 



V 

package COM. Sun. isg. smcjc; 



public class smcrm •{ 

private static byte [ ] parseHandle (String s) { 
int len = s . length () /2 ; 
byte[] h = new byte [ len] ; 
for (int i = 0; i < len; i + +) { 

h[i] = (byte) Integer . parselnt (s . substring (i*2, 
(i+l)*2) / 16); 
} 

25 return h; 

} 

public static void main (String args[]) throws Exception { 
MsmSession session = null; 
MsmPlayer player; 
30 if (args. length != 2) { 

System . err .print In ( "usage : smcrm <serverName> 
<playerHandle>" ) ; 

return; 

} 

try { 

session = new MsmSession (args [0] ) ; 

player = new MsmPlayer (session, parseHandle (args [ 1 ])) ; 
player .delete () ; 
} catch (Exception e) { 

System. err .println ( "smcrm: " + e) ; 
} finally { 

if (session != null) { 
try session . close () ; catch (Exception e) 
45 System, err .println ("smcrm: " + e) ; 

} 

) 

} 

) 

so 
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smcstat 

/* 

5 * @ (#) smcstat .java 

+■ 

* Copyright 1995 Sun Microsystems/ Inc. All Rights Reserved. 

* version 1 . 0 

10 * author Christopher Lindblad 

*/ 

package COM, Sun. isg. smcjc; 

15 

public class smcsta;t { 

public static void main (String args [ ] ) throws Exception { 
MsmSession session - null; 
MsmPlayer [ ] players; 
20 if (args. length != 1) { 



System, err .println ( "usage : smcstat <serverNaitie> M ) 
return; 



} 

25 tr v 



session = new MsmSession (args [0 ]) ; 
players = session . players () ; 
System. out .println (session) ; 
for (int i = 0; i < players . length; i++) { 
30 MsmPlayer player = players [i] ; 

MsmPersistence persistence = player . getPersistence () ; 
MsmConnect connect = player . getConnect () ; 
MsmPlayStatus status = player . getPlayStatus () ; 
MsmAccessRight [ ] rights = player .getAccess () ; 
35 MsmPlaylist playlist = player . getPlaylist () ; 

System. out .println (player) ; 
System. out .println (persistence) ; 
System. out .println (connect) ; 
System. out .println (status) ; 
for (int j = 0; j < rights . length; j++) { 
System. out .println (rights [ j ] ) ; 

} 

System. out .println (playlist ) ; 

for (int j = 0; j < playlist . items . length; j++) { 

if (playlist . items [j ] instanceof MsmTi tlel tern) { 
MsmTitleltem ti = (MsmTitlel tern) playlist . items [ j ] ; 
System. out .println ( 

session. getTi tleS tatus (ti . titleName) ) ; 

50 



40 



45 
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} 

} 

s } catch (Exception e) { 

System. err .println ( "smcstat : " + e) ; 
} finally { 

if (session != null) { 
try session. close () ; catch (Exception e) 
10 System, err . println ( "smcstat : " + e) ; 

} 

} 

} 



20 
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LOOP 

/* 

5 * @(#)loop.c 

* Copyright 1996 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Stephane CACHAT 

*/ 

is ^include <stdio.h> 
#include <stdlib.h> 

•it 

#include <sys/ types . h> 

#include <sys/socket . h> 
20 #include <netinet/in. h> 

#include <arpa/inet . h> 

#include <string.h> 

tfinclude <netdb.h> 
25 #include <signal.h> 

#include <errno.h> 

^include <fcntl.h> 

#include <assert . h> 

#include <unistd.h> 
30 #include <sys/time .h> 

#include <sys/resource,h> 

#include <time.h> 

#include <thread.h> 
3s #include <sys/errno . h> 

#include <sys/stropts . h> 

^include <fcntl.h> 

#include <atm/atmioctl . h> 

40 #ifdef TRUE 
ttundef TRUE 
- #endif 

#ifdef FALSE 
45 #undef FALSE 
#endif 

#define FALSE 0 
so #define TRUE 1 
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#define BUF 1024*8 

*** Global variables *++ 
/* Parameters */ 



char servername [256] ; 
char * progName; 
char *opt; 
int port; 
? 5 int portO; 

/* Socket */ . A 



struct sockaddr_in adds; 
int skt; 

struct sockaddr__in addr; 
struct sockaddr_in addx; 
struct hostent * hp; 
int len; 

/* buffer */ 

char * buffer=MULL; 

/* Multicast */ 

struct ip_mreq mreq; 
char * host; 

/* Thread */ 

thread_t Tpump; 
int okdone=0; 
int flag=l; 



/* ATM V 
int safd; 
45 int ppa; 

char ctlbuf [0x100] ; 



#define vc port 



*** Receive&transmit info Multicast + + + 
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void * pumpM (void * result) { 

while (flag) { /*'!*/ 

len-recvfrom{skt,bu£fer,BUF,0 # OTJLL,0}; P 

if (len) { 

sendto(skt, buffer, len, 0, (struct sockaddr *) 
& (addx) , sizeof (addx) ) ; 
} 

} 

flag=l; 

} 

+ + + + + * + + + # + # + ^ + + 

*** Receive&trarvsmit info ATM + * + 

void * pumpA(void * result) { 
struct strbuf ctl; 
struct strbuf data; 
in t flags; 
f print f (stderr, "pumpAW) ; 
25 ctl.buf = (char *) ctlbuf; 

ctl.maxlen = 0x100; 
ctl. len = 0; 

data.buf = (char +) buffer- 
data. maxlen = 3UF; 
30 data, len = 0; 

flags = 0; 

while (flag) { /+ 

xf <getmsg<safd, & ctl, & data, & flags) < 0) ( ^ P ' 

as pllioU^ derr ' M9etmSg faiied ' errno=%d\n" / errno) ; 

return; 

} 

len^data. len; 
fprintf (stderr, ,, len=%d\n" , len) ; 
40 if (len) { 

,/ J e ^ dto(s)ct ' buffer+ ^len-4 / 0, (struct sockaddr *) 
& (addx) , sizeof (addx) ) ; 
} 

ii 

flag=l; 

} 

so *** Collecting arguments *** 
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void print_usage_and_exit (char* a) { 
5 if (strlen(a)) fprint f (stderr , a) ; 

fprintf (stderr, "\n%s redirect multicast or atm data stream 
to lo0\n" , progName) ; 

fprintf (stderr, "UsageW ) ; 

fprintf (stderr, "%s m <Multicast address> <in port> <out 
w port>\n" , progName) ; 

fprintf (stderr, "%s a <VC> <out port>\n", progName) ; 
(void) exit (0) ; 



75 static void collectArgs (int argcchar **argv) { 
int i; A 
int j=0; 
FILE * f ; 
20 progName=*argv++ ; 

if ( ! *argv) print_usage_and_exi t ( " " ) ; 

opt=*argv++ ; 

if (*opt== , a l ) { 

if ( ! *argv) print_usage_and_exi t ( "" ) ; 
25 port=atoi (*argv++) / 

if ( ! *argv) print__usage_and_exit { " " ) ; 
port0=atoi (*argv++) ; 

if (port<=0) print_usage_and__exit ("" ) ; 
if (*argv) print_usage_and_exit ( " " ) ; 
30 f=fopen(" ./loop.conf", "r") ; 

if (!f) { 

fprintf (stderr, "Can' t open loop.conf") ; 
exit (-1) ; 

host= (char*) malloc(256); 
fscanf (f , "%s",host) ; 
f close ( f ) ; 
}else if (*opt== 'm' ) { 
40 if (!*argv) print_usage_and_exi t ( " " ) ; 

host=*argv++; 

if (!*argv) print__usage_and_exi t ( " " ) ; 
port=atoi (*argv++) ; 

if (!*argv) print_usage_and_exit ( ) ; 
45 port0=atoi (*argv++) ; 

if (port<=0) print_usage_and_exit ("" ) ; 
if (*argv) print_usage_and_exit ("") ; 
} else print — usage_and exit( M "); 

so > 
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/***************************** 
*** Getting server IP adress *** 
**************** ****************** ** + *********** + / 

void getaddr () { 
int udpport; 
unsigned long inaddr; 
struct hostent * hp; 
char n [256] ; 
int i; 



if (gethostname (servername, 256) ==-i) 
print usage and_exit( "error while getting hostname" ) ; 
ir ( Unaddr=inet_addr (servername) ) !=-l) { 

adds . sin_addr . ^_addr=inaddr ; 
}else{ 

hp=gethostbyname (servername) ; 
if (hp!=NULL) { 

adds. sin_addr.s_addr=( (struct in addr*) 
hp->h_addr) ->s_addr; ~ 
^ adds.sin__port = htons (udpport ) ; 

25 } 

if ( <inaddr=inet_addr (host) ) !=-l) {/*hostname*/ . 

mreq.imr_multiaddr.s addr=inaddr; 
}else{ 

30 ^P=gethostbyname (host) ; 

if (hp!=NULL) { 

k ^ m 5! q " imr - mul ti addr. s_addr=( (struct in addr*) 
hp->h_addr) ->s_addr; - 
}else { 

35 ^ fprintf (stderr, "Multicast connect failedW); 

} 

/* nireq.imr__interface.s_addr=INADDR ANY; */ 
gethostname (n, 256) ; ~ 
hp=gethostbyname (n) ; 
if (hp!=NULL) { 

h~ m ^ q ; imr - interfac e.s_addr=( (struct in addr*) 
hp->h_addr) ->s_addr; - 

addx.sin_addr.s_addr=( (struct in addr*) 
hp->h_addr) ->s_addr; ' ~ 

addx.sin port = htons (portO) ; 
}else{ ~ 

^ fprintf (stderr, "Multicast connect failed\n"); 

} 



55 



96 

BN80OCI0: <£P_08O3BBaA3JL> 



* 




EP 0 803 826 A2 




void goM() { 
getaddr () ; 

skt=socket (AF_INET, SOCK_DGRAM, 0) ; 
if (skt==0) { 

perror ( "Create socket"); 

exit (EXIT__FAILURE) ; 

} 

addr .sin_family = AF_INET; 
addr . sin_addr . s_addr = INADDR_ANY; 
addr .sin_port = htons(port); 
bind(skt, (void * ) &addr, sizeof (addr ) ) ; 

iff setsockopt (sJ^t, IPPR0T0_IP, IP__ADD_MEMBERSHIP, (char*) &mreq, 
sizeof (struct ip_mreq) ) == -1 ) { 

fprintf (stderr, "Can' t join multicast membership"); 
exit(O); 

} 

if (fcntl (skt, F_SETFL,0_NDELAY)==-1) { 

fprintf (stderr, "set socket options nb"); 
exit ( EX I T_FAI LURE ) ; 

} 

if (thr_create (0, 0, pumpM, 0, 0, &Tpurnp) ) perror ( "Can 1 1 create 
Dispatcher" ) ; 
} 



unsigned long inaddr; 
struct hostent * hp; 
char n (256] ; 

char interf ace [ 10 ] ; 

memset (interface, 0/ sizeof (interface) ) ; 
strcpy (interf ace, host) ; 

ppa = interface [strlen (interface) - 1] - , 0 I ; 
if ({safd = sa_open (interface) ) < 0) { 

fprintf (stderr, "open failed, errno=%d\n" , errno) ; 

perror ( "open" ) ; 

exit(-l); 

} 

fprintf (stderr, "ready to attach\n") ; 



30 




void goA( ) { 
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int udpport; 
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sa_attach(safd, ppa, -1) ; 
fprintf (stderr, "attached\n" ) ; 



if (sa_add_vpci(safd, vc, NULL ENCAP, BIG BUF TYPE) < 01 t 
} 

sa_setraw (safd) ; 

gethostname (n, 256) ; 
hp=gethostbyname (n) ; 
if (hp!=NULL) { 

k a ^; sin _ add r.s_addr=( (struct in addr*) 

hp->h_addr) -> s _addr; - 

addx.sin_port = htons (portO) ; 
}else{ 

^ fprintf (stderr, "loO connect failedW); 

skt=socket (AF INET,S0CK DGRAM, 0); 
if (skt==0) { 

perror ("Create socket"); 
^ exit (EXIT_FAILURE) ; 

addr . sin_f ami ly = AF_INET; 
addr.sin_addr.s_addr = INADDR ANY; 
addr.sin_port = htons (portO) ;~ 
bind(skt, (void *) &addr,sizeof (addr) ) • 
if (fcntl (skt, F_SETFL,0_NDELAY)==-1) { 

fPr w55 (Stderr '" set sock et options nb"); 
^ exit ( EX I T_ FAILURE) ; 

Disp^tSe^ perrorc-can't create 

) 

Cleaning ATM 

***************** w********^^^^^^^^ 

void doneAUnt arg) { 

flag=0; 

while (!flag) { 
sleep (1) ; 

} 

fprintf (stderr, "dispatcher killed\n") ,• 
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if (sa_delete_vpci (safd, vc) < 0) { 

fprintf (stderr, "sa_delete_vpci failed/ errno=%d\n ,, / errno) 

}; 

fprintf (stderr, "ready to detach\n")/ 

sa_detach (safd, -1) ; 
fprintf (stderr, "detached\n" ) ; 
sa_close (safd) ; 
close (skt) ; 

printf ( "socket closedW); 
if (buffer) free (buff er) ; 
printf ("Buffer free\n") ; 
exit(O); 

} } 

/ + + + + * + + ★ + * + + * + * + + + + + * + + * + + * 

*** Cleaning Multicast *++ 

void doneM(int arg) { 
if ( ! okdone) {okdone=l; 
if (setsockopt (skt, IPPROTO_IP, IP_DROP_MEMBERSHIP, (char *) 
&mreq, sizeof (mreq) )==-l) { 

fprintf (stderr, "Can' t drop multicast membership" ) ; 
exit (0) ; 

} 

printf ("Multicast membership dropped\n" ) ; 
flag=0; 

while (!flag) ( 
sleep(l); 

} 

printf ("dispatcher killed\n" ); 
close (skt) ; 

printf ("socket closed\n" ); 
if (buffer) free (buffer) ; 
printf ("Buffer free\n"); 
exit (0) ; 

} } 

45 

*** Main * + * 
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int main(int argc, char** argv) 
{ 

int i; 
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buf f er= (char* ) malloc (BUF) ; 
collectArgs (argc, argv) ; 
if (*opt== , m l ) { 

printf ("host=% S/ port=%d, port0=%d\n", host, port,port0) / 
signal (SIGQUIT, doneM) ; 
signal (SIGINT, doneM) ; 
signal (SIGUSR1 , doneM) ; 
signal (SIGUSR2, doneM) ; 

printf ("go M\n") ; 
goM ( ) ; 
}else if (+opt== , a I ) { 

printf ("interface=%s, vc=%d, port0=%d\n" , host , vc,port0) ; 
signal (SIGQUIT, doneA) ; 
signal (SIGINT, c^oneA) ; 
signal (SIGUSR1, doneA) ; 
signal (SIGUSR2, doneA) ; 

printf ("go A\n") ; 
goA ( ) ; 

} 

printf ("loop\n") ; 
while (1) sleep (60) ; 

} 
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A method for processing in a computer which includes a memory a bit stream received from a bit stream server 
which is operatively coupled to the computer through a network, the method comprising: 

retrieving from a multimedia document stored in the memory a specification of a title; 

building from the specification of the title bit stream control signals which request a bit stream representing 
the title and which are in a form appropriate for processing by the bit stream server; 

transmitting the bit stream control signals to the bit stream server to thereby request from the bit stream server 
a bit stream representing the title; 

building from the specification of the title decoder control signals which direct a decoder to receive the bit 
stream from the bit stream server and which are in a form appropriate for processing by the decoder; and 
transmitting the decoder control signals to the decoder to thereby cause the decoder to receive and decode 
the bit stream. 

An applet, capable of executing within a computer system, for requesting and controlling decoding of a bit stream 
specified in a multimedia document stored in a memory of the computer system, the applet comprising: 

an API module (i) which is configured to build from a specification of the bit stream in the multimedia document 
bit stream control signals which request transmission of the bit stream from a bit stream server and which are 
in a form appropriate for processing by the bit stream server and (ii) which is configured to transmit the bit 
stream control signals to the bit stream server to thereby request from the bit stream server a bit stream 
representing the title; and 

a decoder module (i) which is operatively coupled to the API module; (ii) which is configured to build from the 
specification of the bit stream in the multimedia document decoder control signals which direct a decoder to 
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receive the bit stream from the bit stream server and which are in a form appropriate for processing by the 
decoder; and (iii) which is configured to transmit the decoder control signals to the decoder to thereby cause 
the decoder to receive and decode the bit stream. 
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(57) The present specification describes a computer 
process which requests streams of motion video titles 
and decodes and displays the motion video signals of 
the stream for display in a computer display device is 
constructed in the form of an applet 21 2 of a multimedia 
document viewer 202 such as a World Wide Web brows- 
er. Accordingly, a designer of multimedia documents 
such as HTML pages can easily incorporate motion vid- 
eo titles into such HTML pages by specifying a few pa- 
rameters of a desired title or a desired portion of a title 
to be requested from a video server 250. The applet 21 2 
builds bit stream control signals from the specification 
of the title or the portion of the title. The bit stream control 
signals request transmission of the title or the portion of 
the title from a bit stream server such as a video server 
250 and are in a form appropriate for processing by the 
bit stream server. The applet 212 transmits the bit 
stream control signals to the bit stream server 250 to 
thereby request that the bit stream server 250 initiate 
transmission of a bit stream representing the requested 
title or the requested portion of the title. The applet 212 
also builds decoder control signals from the specifica- 
tion of the title or the portion of the title. The decoder 
control signals direct a bit stream decoder 204 to receive 
the requested bit stream from the bit stream server 250 
and to decode a motion video signal from the bit stream. 
The applet 212 transmits the decoder control signals to 
the decoder 204 to cause the decoder 204 to receive 
the bit stream and to decode the motion video signal 



from the bit stream. 
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